<!DOCTYPE html>





    

    

    

    

<html lang="en-us">
<!-- Mirrored from docs.memfiredb.com/docs/db/guides/functions-and-operations/ by HTTrack Website Copier/3.x [XR&CO'2014], Fri, 27 Jun 2025 07:56:47 GMT -->
<head>
    <meta charset="utf-8" />
    <title>函数与操作 | MemFire Cloud在线文档</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="keywords" content="Documentation, Hugo, Hugo Theme, Bootstrap" />
    <meta name="author" content="Colin Wilson - Lotus Labs" />
    <meta name="email" content="support@aigis.uk" />
    <meta name="website" content="https://lotusdocs.dev/" />
    <meta name="Version" content="v0.1.0" />
    
    <link rel="icon" href="https://docs.memfiredb.com/favicon.ico" sizes="any">
<link rel="icon" type="image/svg+xml" href="https://docs.memfiredb.com/favicon.svg">
<link rel="apple-touch-icon" sizes="180x180" href="../../../../apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="../../../../favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="../../../../favicon-16x16.png">
<link rel="manifest" crossorigin="use-credentials" href="https://docs.memfiredb.com/site.webmanifest">
<meta property="og:title" content="函数与操作" />
<meta property="og:description" content="逻辑操作符 link常用的逻辑操作符有： AND OR NOT SQL使用三值的逻辑系统，包括真、假和null，null表示“未知”。观察下面的真值表： a b a AND b a OR b TRUE TRUE TRUE TRUE TRUE FALSE FALSE TRUE TRUE NULL NULL TRUE FALSE FALSE FALSE FALSE FALSE NULL FALSE NULL NULL NULL NULL NULL a NOT a TRUE FALSE FALSE TRUE NULL NULL 操作符AND和OR是可交换的，也就是说，你可以交换左右操作数而不影响结果。
比较函数与操作符 link比较操作符可以用于所有可以比较的数据类型。所有比较操作符都是双目操作符，它们返回boolean类型；类似于1 &lt; 2 &lt; 3的表达式是非法的（因为没有&lt;操作符可以比较一个布尔值和3）。
常见的比较操作符都可用，如表所示。
表.比较操作符 操作符 描述 &lt; 小于 &gt; 大于 &lt;= 小于等于 &gt;= 大于等于 = 等于 &lt;&gt; or !" />
<meta property="og:type" content="article" />
<meta property="og:url" content="index.html" /><meta property="og:image" content="../../../../opengraph/card-base-2_hu06b1a92291a380a0d2e0ec03dab66b2f_17642_filter_7996820021541202645.png"/><meta property="article:section" content="docs" />
<meta property="article:published_time" content="2023-12-13T17:39:49+08:00" />
<meta property="article:modified_time" content="2023-12-13T17:39:49+08:00" /><meta name="twitter:card" content="summary_large_image"/>
<meta name="twitter:image" content="../../../../opengraph/card-base-2_hu06b1a92291a380a0d2e0ec03dab66b2f_17642_filter_7996820021541202645.png"/>
<meta name="twitter:title" content="函数与操作"/>
<meta name="twitter:description" content="逻辑操作符 link常用的逻辑操作符有： AND OR NOT SQL使用三值的逻辑系统，包括真、假和null，null表示“未知”。观察下面的真值表： a b a AND b a OR b TRUE TRUE TRUE TRUE TRUE FALSE FALSE TRUE TRUE NULL NULL TRUE FALSE FALSE FALSE FALSE FALSE NULL FALSE NULL NULL NULL NULL NULL a NOT a TRUE FALSE FALSE TRUE NULL NULL 操作符AND和OR是可交换的，也就是说，你可以交换左右操作数而不影响结果。
比较函数与操作符 link比较操作符可以用于所有可以比较的数据类型。所有比较操作符都是双目操作符，它们返回boolean类型；类似于1 &lt; 2 &lt; 3的表达式是非法的（因为没有&lt;操作符可以比较一个布尔值和3）。
常见的比较操作符都可用，如表所示。
表.比较操作符 操作符 描述 &lt; 小于 &gt; 大于 &lt;= 小于等于 &gt;= 大于等于 = 等于 &lt;&gt; or !"/>

    
    <script>(()=>{var t=window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches,e=localStorage.getItem("theme");t&&e===null&&(localStorage.setItem("theme","dark"),document.documentElement.setAttribute("data-dark-mode","")),t&&e==="dark"&&document.documentElement.setAttribute("data-dark-mode",""),e==="dark"&&document.documentElement.setAttribute("data-dark-mode","")})()</script>
    
    
    
    
    
        
        
        
        
    
        
        
        
        
    
    
    <link rel="preconnect" href="https://fonts.gstatic.com/" />
    <link rel="preconnect" href="https://fonts.gstatic.com/" crossorigin />
    <link href="https://fonts.googleapis.com/css?family=Inter:300,400,600,700|Fira+Code:500,700&amp;display=block" rel="stylesheet">

    <link rel="stylesheet" href="../../../scss/style.min.3c376716d7676031e43f6cdc5f3b857642dfe5127f5fd4540ab03d9d4fe8ebac97eff815fbd2f0910dd1307fddf53a15.css"  crossorigin="anonymous">
    
    
    
    </head><body>
        <div class="content">
            <div class="page-wrapper toggled">
<nav id="sidebar" class="sidebar-wrapper">
    <div class="sidebar-brand">
        <a href='../../../overview/index.html' aria-label="HomePage" alt="HomePage">
            
               <svg width="232" height="20" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 232 20">
  <g fill="none" fill-rule="evenodd">
    <text 
      x="50%" 
      y="50%" 
      font-family="Arial, sans-serif" 
      font-size="18" 
      font-weight="bold" 
      fill="#000" 
      text-anchor="middle" 
      dominant-baseline="middle">
      VFORM
    </text>
  </g>
</svg>
            
        </a>
    </div>
    <div class="sidebar-content" style="height: calc(100% - 131px);">
        <ul class="sidebar-menu">
            
                
                
                    
                        
                        <li class="">
                            <a class="sidebar-root-link" href="../../../overview/index.html">
                                <i class="material-icons me-2">dataset</i>
                                
                                文档中心
                            </a>
                        </li>
                    
                
                    
                    
                        <li class="sidebar-dropdown  ">
                            <button class="btn">
                                <i class="material-icons me-2">article</i>
                                产品动向
                            </button>
                            <div class="sidebar-submenu ">
                                <ul>
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    公告
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../announcement/bulletin/bulletins/index.html">【2024年01月03日】MemFire Cloud应用开发正式推出计费套餐</a></li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../../announcement/history/index.html">产品动态</a></li>
                                        
                                    
                                </ul>
                            </div>
                        </li>
                    
                
                    
                    
                        <li class="sidebar-dropdown  ">
                            <button class="btn">
                                <i class="material-icons me-2">deployed_code</i>
                                应用开发
                            </button>
                            <div class="sidebar-submenu ">
                                <ul>
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    概述
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/overview/overview/index.html">介绍</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/overview/features/index.html">功能</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/overview/architecture/index.html">架构</a></li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    购买指南
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/purchase/price/index.html">价格文档</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/purchase/package/index.html">包年包月套餐说明</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/purchase/arrears/index.html">欠费说明</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/purchase/unsubscribe/index.html">退订说明</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/purchase/qa/index.html">计费相关问题</a></li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    快速入门
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-vue-3/index.html">快速入门: Vue</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-react/index.html">快速入门: React</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-flutter/index.html">快速入门: Flutter</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-nextjs/index.html">快速入门: Next.js</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-angular/index.html">快速入门: Angular</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-kotlin/index.html">快速入门: Android Kotlin</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-nuxt-3/index.html">快速入门: Nuxt 3</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-svelte/index.html">快速入门: Svelte</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-ionic-vue/index.html">快速入门: Ionic Vue</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-expo/index.html">快速入门: Expo</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-ionic-angular/index.html">快速入门: Ionic Angular</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-ionic-react/index.html">快速入门: Ionic React</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-redwoodjs/index.html">快速入门: RedwoodJS</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-solidjs/index.html">快速入门: SolidJS</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/quickstart/with-sveltekit/index.html">快速入门: SvelteKit</a></li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    开发指南
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        认证
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth/index.html">概述</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/redirect-urls/index.html">重定向 URL</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/native-mobile-deep-linking/index.html">原生移动深度链接</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-captcha/index.html">启用Captcha保护</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/rate-limiting/index.html">速率限制</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            快速开始
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-getting-start/nextjs/index.html">Next.js 设置微信扫码登录身份验证</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-getting-start/vue/index.html">vue 设置微信扫码登录身份验证</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            身份验证
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/auth-email/index.html">使用电子邮件登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/phoneauth/index.html">手机登录认证</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/wechatauth/index.html">微信小程序登录认证</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/wechatappauth/index.html">微信移动应用授权登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/wechatqrauth/index.html">微信网站应用扫码登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/auth-magic-link/index.html">使用Magic Link登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/auth-apple/index.html">使用Apple登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/auth-github/index.html">使用GitHub登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/auth-gitlab/index.html">使用GitLab登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/authentication/auth-email-templates/index.html">电子邮件模板</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            授权
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/mandates/row-level-security/index.html">行级别安全性</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/mandates/row-level-security2/index.html">RLS使用教程</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/mandates/managing-user-data/index.html">管理用户数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/mandates/server-side-rendering/index.html">服务器端渲染</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/mandates/auth-mfa/index.html">多因素身份验证</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            认证帮助程序
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-helpers/auth-helpers/index.html">身份验证帮助程序</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-helpers/auth-ui/index.html">身份验证UI</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-helpers/nextjs/index.html">使用Next.js进行Supabase认证</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-helpers/sveltekit/index.html">使用SveltKit进行Supabase认证</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-helpers/remix/index.html">Supabase Remix认证</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            深层探索
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-deep-dive/auth-deep-dive-jwts/index.html">第一部分:JWTS</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-deep-dive/auth-row-level-security/index.html">第二部分:行级安全</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-deep-dive/auth-policies/index.html">第三部分:策略</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-deep-dive/auth-gotrue/index.html">第四部分: GoTrue</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/auth/auth-deep-dive/auth-google-oauth/index.html">第五部分: Google Oauth</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        数据库
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/database/index.html">概述</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/connecting-to-postgres/index.html">数据库连接</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/associated-query/index.html">关联查询</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/functions/index.html">数据库函数</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/tables/index.html">表格和数据</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/webhooks/index.html">数据库 Webhooks</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/compute-add-ons/index.html">计算附加组件</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            扩展
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/extensions/index.html">总览</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/http/index.html">http: RESTful客户端</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/pgcron/index.html">pg_cron: 作业调度</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/index_advisor/index.html">index-advisor: 查询优化</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/pg_graphql/index.html">pg_graphql: 为PostgreSQL提供GraphQL功能</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/pgvector/index.html">pgvector: 嵌入向量和向量相似性</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/pgnet/index.html">pg_net: 异步网络</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/pgtap/index.html">pgTAP:单元测试</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/plv8/index.html">plv8: JavaScript语言</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/extensions/uuid-ossp/index.html">uuid-ossp: 唯一标识符</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            配置
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/setting/timeouts/index.html">超时</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/setting/replication/index.html">复制</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/setting/managing-passwords/index.html">Passwords</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/setting/managing-timezones/index.html">时区</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/setting/query-optimization/index.html">查询优化</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            FDW
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/overview/index.html">外部数据包装器(FDW)</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/airtable/index.html">Airtable</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/s3/index.html">AWS S3</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/bigquery/index.html">BigQuery</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/clickhouse/index.html">ClickHouse</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/firebase/index.html">Firebase</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/logflare/index.html">Logflare</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/database/wrappers/stripe/index.html">Stripe</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        无服务器API
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/api/index.html">概述</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/quickstart/index.html">2 分钟构建 API 路由</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/generating-types/index.html">生成类型</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/graphiql/index.html">GraphQL 介绍</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/postman/index.html">使用Postman访问数据</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/curl/index.html">使用cURL工具访问数据</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/securing-your-api/index.html">开始使用</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/api/creating-routes/index.html">创建 API 路由</a></li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        云函数
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/overview/index.html">概述</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/function-management/index.html">管理函数</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/code-development/index.html">代码开发</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/fn-local-test/index.html">云函数本地调试</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/variable/index.html">环境变量</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            函数示例
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/functionexample/helloworld/index.html">helloworld</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/functionexample/wechatpay/index.html">wechatpay</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/functions/functionexample/raffle/index.html">抽奖示例</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        实时数据库
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/realtime/index.html">实时</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/quickstart/index.html">实时快速入门</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/postgres-cdc/index.html">Postgres CDC</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/rate-limits/index.html">实时速率限制</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/concepts/index.html">实时概念</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            用法
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/usage/broadcast/index.html">广播</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/usage/presence/index.html">Presence </a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            指南
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/guides/client-side-throttling/index.html">限制消息</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/guides/postgres-changes/index.html">Postgres 更改</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/guides/realtime-with-nextjs/index.html">将 Realtime 与 Next.js 结合使用</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/guides/subscribing-to-database-changes/index.html">订阅数据库更改</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            深入了解
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/deep-dive/architecture/index.html">实时架构</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/deep-dive/bring-your-own-database/index.html">自带数据库</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/deep-dive/protocol/index.html">实时协议</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/realtime/deep-dive/quotas/index.html">实时配额</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        对象存储
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/storage/storage/index.html">概述</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/storage/storage-cdn/index.html">存储CDN</a></li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        AI 和 Vectors
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/ai/ai/index.html">总览</a></li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        静态托管
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/hosting/static-hosting/index.html">静态托管</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/hosting/static-start/index.html">快速开始</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/hosting/static-domain/index.html">自定义域名</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/development_guide/hosting/real-name-authentication/index.html">实名认证</a></li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    SDK文档
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        JavaScript
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            开始
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/start/javascript/index.html">JavaScript库</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/start/installing/index.html">安装</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/start/initializing/index.html">初始化客户端</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/start/typescript-support/index.html">支持Typescript</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/start/release-notes/index.html">版本说明</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            数据库
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/select/index.html">Select 查询</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/insert/index.html">Insert 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/update/index.html">Update 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/upsert/index.html">Upsert 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/delete/index.html">Delete 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/rpc/index.html">调用Postgres函数</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/filter/index.html">过滤器</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/database/modifier/index.html">修改器</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            认证
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-api/index.html">概述</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-signup/index.html">signUp()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-signinwithpassword/index.html">signInWithPassword()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-signinwithotp/index.html">signInWithOtp()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-signinwithoauth/index.html">signInWithOAuth()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-signout/index.html">signOut()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-resetpasswordforemail/index.html">resetPasswordForEmail()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-verifyotp/index.html">通过 OTP 进行验证和登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-getsession/index.html">getSession()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-refreshsession/index.html">refreshSession()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-getuser/index.html">getUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-updateuser/index.html">updateUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-setsession/index.html">setSession()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth/auth-onauthstatechange/index.html">onAuthStateChange()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            认证（仅限服务端）
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/supabase-auth-admin-api/index.html">概览</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/auth-admin-getuserbyid/index.html">getUserById()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/auth-admin-listusers/index.html">listUsers()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/auth-admin-createuser/index.html">createUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/auth-admin-deleteuser/index.html">deleteUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/auth-admin-inviteuserbyemail/index.html">inviteUserByEmail()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/auth-admin-generatelink/index.html">generateLink()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/auth-admin/auth-admin-updateuserbyid/index.html">updateUserById()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            函数
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/function/invoke/index.html">invoke()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            实时数据库
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/realtime/subscribe/index.html">on().subscribe()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/realtime/removechannel/index.html">removeChannel()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/realtime/removeallchannels/index.html">removeAllChannels()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/realtime/getchannels/index.html">getChannels()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            对象存储
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-createbucket/index.html">createBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-deletebucket/index.html">deleteBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-download/index.html">from.download()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-upload/index.html">from.upload()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-update/index.html">from.update()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-remove/index.html">from.remove()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-list/index.html">from.list()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-move/index.html">from.move()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-copy/index.html">from.copy()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-createsignedurl/index.html">from.createSignedUrl()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-createsignedurls/index.html">from.createSignedUrls()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-from-getpublicurl/index.html">from.getPublicUrl()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-emptybucket/index.html">emptyBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-getbucket/index.html">getBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-listbuckets/index.html">listBuckets()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/javascript/storage/storage-updatebucket/index.html">updateBucket()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        Flutter
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            开始
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/start/dart/index.html">Flutter库</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/start/initializing/index.html">初始化</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/start/installing/index.html">安装</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/start/upgrade-guide/index.html">更新</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            数据库
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/select/index.html">Select 查询</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/insert/index.html">Insert 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/update/index.html">Update 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/upsert/index.html">Upsert 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/delete/index.html">Delete 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/rpc/index.html">存储程序: rpc()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/filter/index.html">过滤器</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/database/modifier/index.html">修改器</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            认证
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-signup/index.html">signUp()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-signinwithpassword/index.html">signInWithPassword()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-signinwithotp/index.html">signInWithOtp()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-signinwithoauth/index.html">signInWithOAuth()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-signout/index.html">signOut()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-verifyotp/index.html">verifyOtp()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-currentsession/index.html">currentSession</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-currentuser/index.html">currentUser</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-updateuser/index.html">updateUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-onauthstatechange/index.html">onAuthStateChange()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/auth/auth-resetpasswordforemail/index.html">resetPasswordForEmail()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            函数
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/function/invoke/index.html">待补充</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            实时数据库
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/realtime/stream/index.html">stream()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/realtime/subscribe/index.html">on().subscribe()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/realtime/removechannel/index.html">removeChannel()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/realtime/removeallchannels/index.html">removeAllChannels()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/realtime/getchannels/index.html">getChannels()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            对象存储
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-createbucket/index.html">createBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-getbucket/index.html">getBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-listbuckets/index.html">listBuckets()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-updatebucket/index.html">updateBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-deletebucket/index.html">deleteBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-emptybucket/index.html">emptyBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-upload/index.html">from.upload()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-download/index.html">from.download()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-list/index.html">from.list()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-update/index.html">from.update()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-move/index.html">from.move()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-remove/index.html">from.remove()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-createsignedurl/index.html">from.createSignedUrl()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-createsignedurls/index.html">from.createSignedUrls()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/dart/storage/storage-from-getpublicurl/index.html">from.getPublicUrl()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        微信小程序
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            开始
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/start/wechat/index.html">微信小程序客户端</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/start/installing/index.html">安装</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/start/initializing/index.html">初始化客户端</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/start/typescript-support/index.html">支持Typescript</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/start/release-notes/index.html">版本说明</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            数据库
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/select/index.html">Select 查询</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/insert/index.html">Insert 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/update/index.html">Update 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/upsert/index.html">Upsert 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/delete/index.html">Delete 数据</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/rpc/index.html">调用Postgres函数</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/filter/index.html">过滤器</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/database/modifier/index.html">修改器</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            认证
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-api/index.html">概述</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-signinwithwechat/index.html">signInWithWechat()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-wechatbindphone/index.html">getUnlimitedQRCode()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-getunlimitedqrcode/index.html">signInWithWechat()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-wechatbindaccount/index.html">wechatBindAccount()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-updateuser/index.html">updateUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-signup/index.html">signUp()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-signinwithpassword/index.html">signInWithPassword()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-signinwithotp/index.html">signInWithOtp()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-signinwithoauth/index.html">signInWithOAuth()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-signout/index.html">signOut()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-verifyotp/index.html">通过 OTP 进行验证和登录</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-getsession/index.html">getSession()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-refreshsession/index.html">refreshSession()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-getuser/index.html">getUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-setsession/index.html">setSession()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-onauthstatechange/index.html">onAuthStateChange()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth/auth-resetpasswordforemail/index.html">resetPasswordForEmail()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            认证（仅限服务端）
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/auth-admin-listusers/index.html">listUsers()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/supabase-auth-admin-api/index.html">概览</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/auth-admin-createuser/index.html">createUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/auth-admin-deleteuser/index.html">deleteUser()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/auth-admin-generatelink/index.html">generateLink()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/auth-admin-inviteuserbyemail/index.html">inviteUserByEmail()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/auth-admin-getuserbyid/index.html">getUserById()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/auth-admin/auth-admin-updateuserbyid/index.html">updateUserById()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            函数
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/function/invoke/index.html">invoke()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            实时数据库
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/realtime/subscribe/index.html">on().subscribe()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/realtime/removechannel/index.html">removeChannel()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/realtime/removeallchannels/index.html">removeAllChannels()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/realtime/getchannels/index.html">getChannels()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class="sidebar-dropdown nested  ">
                                                                                        <button class="btn">
                                                                                            
                                                                                            对象存储
                                                                                        </button>
                                                                                        <div class="sidebar-submenu ">
                                                                                            <ul>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-createbucket/index.html">createBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-getbucket/index.html">getBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-listbuckets/index.html">listBuckets()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-updatebucket/index.html">updateBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-deletebucket/index.html">deleteBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-emptybucket/index.html">emptyBucket()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-upload/index.html">from.upload()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-download/index.html">from.download()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-list/index.html">from.list()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-update/index.html">from.update()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-move/index.html">from.move()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-copy/index.html">from.copy()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-remove/index.html">from.remove()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-createsignedurl/index.html">from.createSignedUrl()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-createsignedurls/index.html">from.createSignedUrls()</a></li>
                                                                                                
                                                                                                    
                                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/sdkdocs/wechatsdk/storage/storage-from-getpublicurl/index.html">from.getPublicUrl()</a></li>
                                                                                                
                                                                                            </ul>
                                                                                        </div>
                                                                                    </li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    最佳实践
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../../app/example/scaffold/index.html">前端框架的脚手架</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        微信小程序
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/example/wechat/timetable/index.html">Super课表小程序</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/example/wechat/hellobbs/index.html">BBS论坛小程序</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/example/wechat/notclickwhite/index.html">别踩白块游戏小程序</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/example/wechat/wechatroom/index.html">微信小程序聊天室</a></li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="sidebar-dropdown nested  ">
                                                                    <button class="btn">
                                                                        
                                                                        Web
                                                                    </button>
                                                                    <div class="sidebar-submenu ">
                                                                        <ul>
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/example/web/postsforum/index.html">Posts社交网络论坛</a></li>
                                                                                
                                                                            
                                                                                
                                                                                
                                                                                    <li class=" "><a class="sidebar-nested-link" href="../../../app/example/web/playground/index.html">实时游戏场</a></li>
                                                                                
                                                                            
                                                                        </ul>
                                                                    </div>
                                                                </li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                </ul>
                            </div>
                        </li>
                    
                
                    
                    
                        <li class="sidebar-dropdown  current active">
                            <button class="btn">
                                <i class="material-icons me-2">database</i>
                                云数据库
                            </button>
                            <div class="sidebar-submenu d-block">
                                <ul>
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../db-introduction/index.html">介绍</a></li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../database-management/index.html">数据库管理</a></li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../account-management/index.html">账号管理</a></li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../backup-and-recovery/index.html">备份恢复</a></li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../online-sql-editor/index.html">在线SQL编辑器</a></li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../client-connection/index.html">客户端工具</a></li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../introduction-to-sql-operation/index.html">SQL操作入门</a></li>
                                        
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  ">
                                                <button class="btn">
                                                    
                                                    开发示例
                                                </button>
                                                <div class="sidebar-submenu ">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/python-example/index.html">Python2示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/python3-example/index.html">Python3示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/java-example/index.html">Java示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/golang-example/index.html">Golang示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/spring-example/index.html">Spring示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/node-example/index.html">Node示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/c%2b%2b-example/index.html">C&#43;&#43;示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/c-example/index.html">C#示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/c2-example/index.html">C示例</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../../example/development-example/index.html"></a></li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                        
                                        
                                            <li class=" "><a class="sidebar-nested-link" href="../../memfiredb-data-migration/index.html">数据迁移</a></li>
                                        
                                    
                                        
                                        
                                            <li class="sidebar-dropdown nested  current active">
                                                <button class="btn">
                                                    
                                                    参考指南
                                                </button>
                                                <div class="sidebar-submenu d-block">
                                                    <ul>
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../compatibility/index.html">兼容性说明</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../keyword/index.html">关键字</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../data-type/index.html">数据类型</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class=" "><a class="sidebar-nested-link" href="../sql-grammar/index.html">SQL语法</a></li>
                                                            
                                                        
                                                            
                                                            
                                                                <li class="current "><a class="sidebar-nested-link" href="index.html">函数与操作</a></li>
                                                            
                                                        
                                                    </ul>
                                                </div>
                                            </li>
                                        
                                    
                                </ul>
                            </div>
                        </li>
                    
                
                    
                        
                        <li class="">
                            <a class="sidebar-root-link" href="../../../contactus/index.html">
                                <i class="material-icons me-2">article</i>
                                
                                联系我们
                            </a>
                        </li>
                    
                
                    
                        
                        <li class="">
                            <a class="sidebar-root-link" href="../../../frequently-asked-questions/index.html">
                                <i class="material-icons me-2">quiz</i>
                                
                                常见问题解答（FAQ）
                            </a>
                        </li>
                    
                
            
        </ul>
        
    </div>
    
        <ul class="sidebar-footer list-unstyled mb-0">
            
        </ul>
    
</nav>

                    <main class="page-content bg-transparent">
                        
<div id="top-header" class="top-header d-print-none">
    <div class="header-bar d-flex justify-content-between">
        <div class="d-flex align-items-center">
            <a href='https://docs.memfiredb.com/' class="logo-icon me-3" aria-label="HomePage" alt="HomePage">
                <div class="small">
                    
                            <?xml version="1.0" encoding="UTF-8"?>
<svg width="99px" height="112px" viewBox="0 0 99 112" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
    <title>MemFireDB备份 6</title>
    <defs>
        <linearGradient x1="49.9999885%" y1="98.082503%" x2="49.9999885%" y2="0.766550128%" id="linearGradient-1">
            <stop stop-color="#ED1C23" offset="0%"></stop>
            <stop stop-color="#FBAF3B" offset="100%"></stop>
        </linearGradient>
    </defs>
    <g id="定稿" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
        <g id="MemFireDB备份-6">
            <polygon id="Fill-1" fill="#F9AE7C" points="25.9728553 40.7912363 47.4268317 0.00591833831 1.15453123 26.7215251"></polygon>
            <polygon id="Fill-3" fill="#F9AE7C" points="97.4213117 26.7267606 51.1285247 0.000910513587 72.4242993 40.8351686"></polygon>
            <polygon id="Fill-5" fill="#F9904A" points="24.8347133 42.7618153 0.000455256793 28.682999 0.000455256793 82.1608764"></polygon>
            <polygon id="Fill-7" fill="url(#linearGradient-1)" points="27.6634514 42.4662399 49.279044 109.05096 70.7296059 42.507213 49.2779058 1.3747617"></polygon>
            <polygon id="Fill-9" fill="#F9904A" points="98.5660549 28.6951771 73.5622137 42.8047233 98.5660549 82.1719163"></polygon>
            <polygon id="Fill-13" fill="#FB6D33" points="72.2987623 45.061545 50.7514582 111.900071 97.579172 84.8646465"></polygon>
            <polygon id="Fill-15" fill="#FB6D33" points="26.1006687 45.0226206 0.987565799 84.8644188 47.8095888 111.898705"></polygon>
            <path d="M60.0737516,38.507213 C59.3168872,35.669825 57.0462939,33.3514298 57.0462939,33.3514298 C57.0462939,33.3514298 57.0804382,35.8849338 56.2894295,37.513615 C55.4847631,39.1696116 53.8765685,40.3054773 53.8765685,40.3054773 C53.8765685,40.3054773 56.1016361,33.8840802 54.2715038,30.1247973 C52.0259496,25.5073552 49.1771803,23.3357803 49.1771803,23.3357803 C49.1771803,23.3357803 50.1070423,28.1319107 48.6240432,31.5065016 C47.1672215,34.8264618 42.8058614,36.7260208 40.7241997,38.7132167 C39.1865699,40.1791435 38.0814341,43.0711623 37.6068289,44.4847347 C37.5715465,44.5883056 37.560165,44.6918765 37.5533362,44.7943093 C37.584066,43.9816759 37.8890881,39.8024186 40.9654858,37.4293925 C43.8404325,35.2111538 41.2431925,30.3478731 41.2431925,30.3478731 C41.2431925,30.3478731 41.7212121,32.5638355 40.9939394,34.1401622 C40.2655285,35.7153507 38.7187936,36.5962726 38.0154218,38.259098 C37.3883056,39.7409589 37.5203301,44.1432921 37.5453692,44.8409731 C37.5453692,44.8591834 37.5476455,44.8762555 37.5476455,44.8921895 C37.5476455,44.9263338 37.5487836,44.9456822 37.5487836,44.9456822 L37.5487836,44.9115379 C37.5590269,45.2655001 37.7138142,45.6080808 37.9972116,45.8448143 L48.3713757,55.6442168 C48.8380139,56.0323232 49.5163466,56.0334614 49.9841229,55.6476312 L60.5938825,45.7105136 C60.9034571,45.4544316 61.0719021,45.0686015 61.0457249,44.6656992 C60.9546735,43.2282259 60.5699815,40.3692133 60.0737516,38.507213" id="Fill-17" fill="#FFFFFF"></path>
        </g>
    </g>
</svg>
                    
                </div>
                <div class="big">
                    
                           <svg width="232" height="20" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 232 20">
  <g fill="none" fill-rule="evenodd">
    <text 
      x="50%" 
      y="50%" 
      font-family="Arial, sans-serif" 
      font-size="18" 
      font-weight="bold" 
      fill="#000" 
      text-anchor="middle" 
      dominant-baseline="middle">
      VFORM
    </text>
  </g>
</svg>
                    
                </div>
            </a>
            <button id="close-sidebar" class="btn btn-icon btn-soft">
                <span class="material-icons size-20 menu-icon align-middle">menu</span>
            </button>
            
            </div>

        <div class="d-flex align-items-center">
            <ul class="list-unstyled mb-0">
                
            </ul>
            <a  class="btn btn-icon btn-default ms-4"  type="button" href="https://memfiredb.com/"  target="_blank" >官网</a>
            <a  class="btn btn-icon btn-default ms-4" type="button" href="https://community.memfiredb.com/"  target="_blank"  >论坛</a>
            <a  class="btn btn-icon btn-default ms-4" type="button" href="https://cloud.memfiredb.com/auth/login"  target="_blank"  >登录</a>
            <button id="mode" class="btn btn-icon btn-default ms-2" type="button" aria-label="Toggle user interface mode">
                <span class="toggle-dark">
                    <svg xmlns="http://www.w3.org/2000/svg" height="30" width="30" viewBox="0 0 48 48" fill="currentColor">
                        <title>Enable dark mode</title>
                        <path d="M24 42q-7.5 0-12.75-5.25T6 24q0-7.5 5.25-12.75T24 6q.4 0 .85.025.45.025 1.15.075-1.8 1.6-2.8 3.95-1 2.35-1 4.95 0 4.5 3.15 7.65Q28.5 25.8 33 25.8q2.6 0 4.95-.925T41.9 22.3q.05.6.075.975Q42 23.65 42 24q0 7.5-5.25 12.75T24 42Zm0-3q5.45 0 9.5-3.375t5.05-7.925q-1.25.55-2.675.825Q34.45 28.8 33 28.8q-5.75 0-9.775-4.025T19.2 15q0-1.2.25-2.575.25-1.375.9-3.125-4.9 1.35-8.125 5.475Q9 18.9 9 24q0 6.25 4.375 10.625T24 39Zm-.2-14.85Z"/>
                    </svg>
                </span>
                <span class="toggle-light">
                    <svg xmlns="http://www.w3.org/2000/svg" height="30" width="30" viewBox="0 0 48 48" fill="currentColor">
                        <title>Enable light mode</title>
                        <path d="M24 31q2.9 0 4.95-2.05Q31 26.9 31 24q0-2.9-2.05-4.95Q26.9 17 24 17q-2.9 0-4.95 2.05Q17 21.1 17 24q0 2.9 2.05 4.95Q21.1 31 24 31Zm0 3q-4.15 0-7.075-2.925T14 24q0-4.15 2.925-7.075T24 14q4.15 0 7.075 2.925T34 24q0 4.15-2.925 7.075T24 34ZM3.5 25.5q-.65 0-1.075-.425Q2 24.65 2 24q0-.65.425-1.075Q2.85 22.5 3.5 22.5h5q.65 0 1.075.425Q10 23.35 10 24q0 .65-.425 1.075-.425.425-1.075.425Zm36 0q-.65 0-1.075-.425Q38 24.65 38 24q0-.65.425-1.075.425-.425 1.075-.425h5q.65 0 1.075.425Q46 23.35 46 24q0 .65-.425 1.075-.425.425-1.075.425ZM24 10q-.65 0-1.075-.425Q22.5 9.15 22.5 8.5v-5q0-.65.425-1.075Q23.35 2 24 2q.65 0 1.075.425.425.425.425 1.075v5q0 .65-.425 1.075Q24.65 10 24 10Zm0 36q-.65 0-1.075-.425-.425-.425-.425-1.075v-5q0-.65.425-1.075Q23.35 38 24 38q.65 0 1.075.425.425.425.425 1.075v5q0 .65-.425 1.075Q24.65 46 24 46ZM12 14.1l-2.85-2.8q-.45-.45-.425-1.075.025-.625.425-1.075.45-.45 1.075-.45t1.075.45L14.1 12q.4.45.4 1.05 0 .6-.4 1-.4.45-1.025.45-.625 0-1.075-.4Zm24.7 24.75L33.9 36q-.4-.45-.4-1.075t.45-1.025q.4-.45 1-.45t1.05.45l2.85 2.8q.45.45.425 1.075-.025.625-.425 1.075-.45.45-1.075.45t-1.075-.45ZM33.9 14.1q-.45-.45-.45-1.05 0-.6.45-1.05l2.8-2.85q.45-.45 1.075-.425.625.025 1.075.425.45.45.45 1.075t-.45 1.075L36 14.1q-.4.4-1.025.4-.625 0-1.075-.4ZM9.15 38.85q-.45-.45-.45-1.075t.45-1.075L12 33.9q.45-.45 1.05-.45.6 0 1.05.45.45.45.45 1.05 0 .6-.45 1.05l-2.8 2.85q-.45.45-1.075.425-.625-.025-1.075-.425ZM24 24Z"/>
                    </svg>
                </span>
            </button>
            
        </div>
    </div>
    
    
    
</div>

                            <div class="container-fluid">
                                <div class="layout-spacing">
                                    
                                        <div class="d-md-flex justify-content-between align-items-center"><nav aria-label="breadcrumb" class="d-inline-block pb-2 mt-1 mt-sm-0">
    <ul id="breadcrumbs" class="breadcrumb bg-transparent mb-0" itemscope itemtype="https://schema.org/BreadcrumbList">
        
            
                <li class="breadcrumb-item text-capitalize active" aria-current="page" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
                    <a itemprop="item" href="../../../index.html">
                        <i class="material-icons size-20 align-text-bottom" itemprop="name">Home</i>
                    </a>
                    <meta itemprop="position" content='1' />
                </li>
            
            
                <li class="breadcrumb-item text-capitalize" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
                    <a itemprop="item" href="../../index.html">
                        <span itemprop="name">云数据库</span>
                    </a>
                    <meta itemprop="position" content='2' />
                </li>
            
            
                <li class="breadcrumb-item text-capitalize" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
                    <a itemprop="item" href="../index.html">
                        <span itemprop="name">参考指南</span>
                    </a>
                    <meta itemprop="position" content='3' />
                </li>
            
        
            <li class="breadcrumb-item text-capitalize active" itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
                <span itemprop="name">函数与操作</span>
                <meta itemprop="position" content='4' />
            </li>
        
    </ul>
</nav></div>
                                    
                                    <div class="row flex-xl-nowrap">
                                        
                                        <div class="docs-toc col-xl-3    d-xl-block"><toc>
    <div class="fw-bold text-uppercase mb-2">本页</div>
    <nav id="toc">
  <ul>
    <li><a href="#逻辑操作符">逻辑操作符</a>
      <ul>
        <li><a href="#比较函数与操作符">比较函数与操作符</a></li>
        <li><a href="#数学函数和操作符">数学函数和操作符</a>
          <ul>
            <li><a href="#数学操作符">数学操作符</a></li>
            <li><a href="#数学函数">数学函数</a></li>
            <li><a href="#随机函数">随机函数</a></li>
            <li><a href="#三角函数">三角函数</a></li>
          </ul>
        </li>
        <li><a href="#字符串函数和操作符">字符串函数和操作符</a></li>
        <li><a href="#二进制串函数与操作符">二进制串函数与操作符</a></li>
        <li><a href="#位串函数和操作符">位串函数和操作符</a></li>
        <li><a href="#模式匹配">模式匹配</a>
          <ul>
            <li><a href="#like">LIKE</a></li>
            <li><a href="#similar-to正则表达式">SIMILAR TO正则表达式</a></li>
            <li><a href="#posix正则表达式">POSIX正则表达式</a></li>
          </ul>
        </li>
        <li><a href="#数据类型格式化函数">数据类型格式化函数</a></li>
        <li><a href="#时间日期函数和操作符">时间/日期函数和操作符</a>
          <ul>
            <li><a href="#extract-date_part">EXTRACT, date_part</a></li>
            <li><a href="#date_trunc">date_trunc</a></li>
            <li><a href="#at-time-zone">AT TIME ZONE</a></li>
            <li><a href="#当前日期时间">当前日期/时间</a></li>
            <li><a href="#延时执行">延时执行</a></li>
          </ul>
        </li>
        <li><a href="#枚举支持函数">枚举支持函数</a></li>
        <li><a href="#几何函数和操作符">几何函数和操作符</a></li>
        <li><a href="#网络地址函数和操作符">网络地址函数和操作符</a></li>
        <li><a href="#文本搜索函数和操作符">文本搜索函数和操作符</a></li>
        <li><a href="#json函数与操作符">JSON函数与操作符</a></li>
        <li><a href="#序列操作函数">序列操作函数</a></li>
        <li><a href="#条件表达式">条件表达式</a>
          <ul>
            <li><a href="#case">CASE</a></li>
            <li><a href="#coalesce">COALESCE</a></li>
            <li><a href="#nullif">NULLIF</a></li>
            <li><a href="#greatest和least">GREATEST和LEAST</a></li>
          </ul>
        </li>
        <li><a href="#数组函数与操作符">数组函数与操作符</a></li>
        <li><a href="#范围函数和操作符">范围函数和操作符</a></li>
        <li><a href="#聚集函数">聚集函数</a></li>
        <li><a href="#窗口函数">窗口函数</a></li>
        <li><a href="#子查询表达式">子查询表达式</a>
          <ul>
            <li><a href="#exists">EXISTS</a></li>
            <li><a href="#in">IN</a></li>
            <li><a href="#not-in">NOT IN</a></li>
            <li><a href="#anysome">ANY/SOME</a></li>
            <li><a href="#all">ALL</a></li>
            <li><a href="#单一行比较">单一行比较</a></li>
          </ul>
        </li>
        <li><a href="#行与数组比较">行与数组比较</a>
          <ul>
            <li><a href="#in-1">IN</a></li>
            <li><a href="#not-in-1">NOT IN</a></li>
            <li><a href="#anysome-array">ANY/SOME (array)</a></li>
            <li><a href="#all-array">ALL (array)</a></li>
            <li><a href="#行构造器比较">行构造器比较</a></li>
            <li><a href="#组合类型比较">组合类型比较</a></li>
          </ul>
        </li>
        <li><a href="#集合返回函数">集合返回函数</a></li>
      </ul>
    </li>
  </ul>
</nav>
    </toc></div>
                                        
                                        
                                        <div class="docs-toc-mobile    d-print-none d-xl-none">
                                            <button id="toc-dropdown-btn" class="btn-secondary dropdown-toggle" type="button" data-bs-toggle="dropdown" data-bs-offset="0,0" aria-expanded="false">
                                                Table of Contents
                                            </button>
<nav id="toc-mobile">
  <ul class="dropdown-menu">
    <li><a href="#逻辑操作符">逻辑操作符</a>
      <ul>
        <li><a href="#比较函数与操作符">比较函数与操作符</a></li>
        <li><a href="#数学函数和操作符">数学函数和操作符</a>
          <ul>
            <li><a href="#数学操作符">数学操作符</a></li>
            <li><a href="#数学函数">数学函数</a></li>
            <li><a href="#随机函数">随机函数</a></li>
            <li><a href="#三角函数">三角函数</a></li>
          </ul>
        </li>
        <li><a href="#字符串函数和操作符">字符串函数和操作符</a></li>
        <li><a href="#二进制串函数与操作符">二进制串函数与操作符</a></li>
        <li><a href="#位串函数和操作符">位串函数和操作符</a></li>
        <li><a href="#模式匹配">模式匹配</a>
          <ul>
            <li><a href="#like">LIKE</a></li>
            <li><a href="#similar-to正则表达式">SIMILAR TO正则表达式</a></li>
            <li><a href="#posix正则表达式">POSIX正则表达式</a></li>
          </ul>
        </li>
        <li><a href="#数据类型格式化函数">数据类型格式化函数</a></li>
        <li><a href="#时间日期函数和操作符">时间/日期函数和操作符</a>
          <ul>
            <li><a href="#extract-date_part">EXTRACT, date_part</a></li>
            <li><a href="#date_trunc">date_trunc</a></li>
            <li><a href="#at-time-zone">AT TIME ZONE</a></li>
            <li><a href="#当前日期时间">当前日期/时间</a></li>
            <li><a href="#延时执行">延时执行</a></li>
          </ul>
        </li>
        <li><a href="#枚举支持函数">枚举支持函数</a></li>
        <li><a href="#几何函数和操作符">几何函数和操作符</a></li>
        <li><a href="#网络地址函数和操作符">网络地址函数和操作符</a></li>
        <li><a href="#文本搜索函数和操作符">文本搜索函数和操作符</a></li>
        <li><a href="#json函数与操作符">JSON函数与操作符</a></li>
        <li><a href="#序列操作函数">序列操作函数</a></li>
        <li><a href="#条件表达式">条件表达式</a>
          <ul>
            <li><a href="#case">CASE</a></li>
            <li><a href="#coalesce">COALESCE</a></li>
            <li><a href="#nullif">NULLIF</a></li>
            <li><a href="#greatest和least">GREATEST和LEAST</a></li>
          </ul>
        </li>
        <li><a href="#数组函数与操作符">数组函数与操作符</a></li>
        <li><a href="#范围函数和操作符">范围函数和操作符</a></li>
        <li><a href="#聚集函数">聚集函数</a></li>
        <li><a href="#窗口函数">窗口函数</a></li>
        <li><a href="#子查询表达式">子查询表达式</a>
          <ul>
            <li><a href="#exists">EXISTS</a></li>
            <li><a href="#in">IN</a></li>
            <li><a href="#not-in">NOT IN</a></li>
            <li><a href="#anysome">ANY/SOME</a></li>
            <li><a href="#all">ALL</a></li>
            <li><a href="#单一行比较">单一行比较</a></li>
          </ul>
        </li>
        <li><a href="#行与数组比较">行与数组比较</a>
          <ul>
            <li><a href="#in-1">IN</a></li>
            <li><a href="#not-in-1">NOT IN</a></li>
            <li><a href="#anysome-array">ANY/SOME (array)</a></li>
            <li><a href="#all-array">ALL (array)</a></li>
            <li><a href="#行构造器比较">行构造器比较</a></li>
            <li><a href="#组合类型比较">组合类型比较</a></li>
          </ul>
        </li>
        <li><a href="#集合返回函数">集合返回函数</a></li>
      </ul>
    </li>
  </ul>
</nav></div>
                                        <div class="docs-content col-12 col-xl-9 mt-0">
                                            <div class="mb-0 d-flex">
                                                
                                                <h1 class="content-title mb-0">
                                                    函数与操作
                                                    
                                                </h1>
                                            </div>
                                            
                                            <div id="content" class="main-content" data-bs-spy="scroll" data-bs-root-margin="0px 0px -65%" data-bs-target="#toc-mobile">
                                                
    
    <div data-prismjs-copy="" data-prismjs-copy-success="" data-prismjs-copy-error="">
        <h1 id="逻辑操作符">逻辑操作符 <a href="#%e9%80%bb%e8%be%91%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h1><p>常用的逻辑操作符有：







<table class="table table-striped">
<thead>
<tr>
<th>AND</th>
</tr>
</thead>
<tbody>
<tr>
<td>OR</td>
</tr>
<tr>
<td>NOT</td>
</tr>
</tbody>
</table>
</p>
<p>SQL使用三值的逻辑系统，包括真、假和null，null表示“未知”。观察下面的真值表：







<table class="table table-striped">
<thead>
<tr>
<th>a</th>
<th>b</th>
<th>a AND b</th>
<th>a OR b</th>
</tr>
</thead>
<tbody>
<tr>
<td>TRUE</td>
<td>TRUE</td>
<td>TRUE</td>
<td>TRUE</td>
</tr>
<tr>
<td>TRUE</td>
<td>FALSE</td>
<td>FALSE</td>
<td>TRUE</td>
</tr>
<tr>
<td>TRUE</td>
<td>NULL</td>
<td>NULL</td>
<td>TRUE</td>
</tr>
<tr>
<td>FALSE</td>
<td>FALSE</td>
<td>FALSE</td>
<td>FALSE</td>
</tr>
<tr>
<td>FALSE</td>
<td>NULL</td>
<td>FALSE</td>
<td>NULL</td>
</tr>
<tr>
<td>NULL</td>
<td>NULL</td>
<td>NULL</td>
<td>NULL</td>
</tr>
</tbody>
</table>
</p>







<table class="table table-striped">
<thead>
<tr>
<th>a</th>
<th>NOT a</th>
</tr>
</thead>
<tbody>
<tr>
<td>TRUE</td>
<td>FALSE</td>
</tr>
<tr>
<td>FALSE</td>
<td>TRUE</td>
</tr>
<tr>
<td>NULL</td>
<td>NULL</td>
</tr>
</tbody>
</table>

<p>操作符AND和OR是可交换的，也就是说，你可以交换左右操作数而不影响结果。</p>
<h2 id="比较函数与操作符">比较函数与操作符 <a href="#%e6%af%94%e8%be%83%e5%87%bd%e6%95%b0%e4%b8%8e%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>比较操作符可以用于所有可以比较的数据类型。所有比较操作符都是双目操作符，它们返回boolean类型；类似于1 &lt; 2 &lt; 3的表达式是非法的（因为没有&lt;操作符可以比较一个布尔值和3）。</p>
<p>常见的比较操作符都可用，如表所示。</p>
<p><strong>表.比较操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>操作符</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>&lt;</td>
<td>小于</td>
</tr>
<tr>
<td>&gt;</td>
<td>大于</td>
</tr>
<tr>
<td>&lt;=</td>
<td>小于等于</td>
</tr>
<tr>
<td>&gt;=</td>
<td>大于等于</td>
</tr>
<tr>
<td>=</td>
<td>等于</td>
</tr>
<tr>
<td>&lt;&gt; or !=</td>
<td>不等于</td>
</tr>
</tbody>
</table>
</p>
<p>注意</p>
<p>!=操作符在分析器阶段被转换成&lt;&gt;。不能把!=和&lt;&gt;操作符实现为做不同的事。</p>
<p>如表所示，也有一些比较谓词。它们的行为和操作符很像，但是具有 SQL 标准所要求的特殊语法。</p>
<p><strong>表.比较谓词</strong>







<table class="table table-striped">
<thead>
<tr>
<th>谓词</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>a BETWEEN x AND y</td>
<td>在x和y之间</td>
</tr>
<tr>
<td>a NOT BETWEEN x AND y</td>
<td>不在x和y之间</td>
</tr>
<tr>
<td>a BETWEEN  SYMMETRIC x AND y</td>
<td>在对比较值排序后位于x和y之间</td>
</tr>
<tr>
<td>a NOT BETWEEN  SYMMETRIC x AND y</td>
<td>在对比较值排序后不位于x和y之间</td>
</tr>
<tr>
<td>a IS DISTINCT FROM b</td>
<td>不等于，空值被当做一个普通值</td>
</tr>
<tr>
<td>a IS NOT DISTINCT FROM b</td>
<td>等于，空值被当做一个普通值</td>
</tr>
<tr>
<td>expression IS NULL</td>
<td>是空值</td>
</tr>
<tr>
<td>expression IS NOT NULL</td>
<td>不是空值</td>
</tr>
<tr>
<td>expression ISNULL</td>
<td>是空值（非标准语法）</td>
</tr>
<tr>
<td>expression NOTNULL</td>
<td>不是空值（非标准语法）</td>
</tr>
<tr>
<td>boolean_expression IS TRUE</td>
<td>为真</td>
</tr>
<tr>
<td>boolean_expression IS NOT TRUE</td>
<td>为假或未知</td>
</tr>
<tr>
<td>boolean_expression IS FALSE</td>
<td>为假</td>
</tr>
<tr>
<td>boolean_expression IS NOT FALSE</td>
<td>为真或者未知</td>
</tr>
<tr>
<td>boolean_expression IS UNKNOWN</td>
<td>值为未知</td>
</tr>
<tr>
<td>boolean_expression IS NOT UNKNOWN</td>
<td>为真或者为假</td>
</tr>
</tbody>
</table>
</p>
<p>BETWEEN谓词可以简化范围测试：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="05b5a96" class="language-sql ">
  <code>a BETWEEN x AND y</code>
  </pre>
  </div>
<p>等效于</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="0a45624" class="language-sql ">
  <code>a &gt;= x AND a &lt;= y</code>
  </pre>
  </div>
<p>注意BETWEEN认为终点值是包含在范围内的。 NOT BETWEEN可以做相反比较：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="3ae4806" class="language-sql ">
  <code>a NOT BETWEEN x AND y</code>
  </pre>
  </div>
<p>等效于</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="358d218" class="language-sql ">
  <code>a &lt; x OR a &gt; y</code>
  </pre>
  </div>
<p>BETWEEN SYMMETRIC和BETWEEN相似，不过BETWEEN SYMMETRIC不要求AND左边的参数小于或等于右边的参数。如果左参数不是小于等于右参数，这两个参数会自动被交换，这样总是会应用一个非空范围。</p>
<p>当有一个输入为空时，普通的比较操作符会得到空（表示“未知”），而不是真或假。例如，7 = NULL得到空，7 &lt;&gt; NULL也一样。如果这种行为不合适，可以使用IS [ NOT ] DISTINCT FROM谓词：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="69f8de2" class="language-sql ">
  <code>a IS DISTINCT FROM b
a IS NOT DISTINCT FROM b</code>
  </pre>
  </div>
<p>对于非空输入，IS DISTINCT FROM和&lt;&gt;操作符一样。不过，如果两个输入都为空，它会返回假。而如果只有一个输入为空，它会返回真。类似地，IS NOT DISTINCT FROM对于非空输入的行为与=相同，但是当两个输入都为空时它返回真，并且当只有一个输入为空时返回假。因此，这些谓词实际上把空值当作一种普通数据值而不是“unknown”。</p>
<p>要检查一个值是否为空，使用下面的谓词：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="5c36f76" class="language-sql ">
  <code>expression IS NULL
expression IS NOT NULL</code>
  </pre>
  </div>
<p>或者等效，但并不标准的谓词：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4d9b963" class="language-sql ">
  <code>expression ISNULL
expression NOTNULL</code>
  </pre>
  </div>
<p>不要写expression = NULL，因为NULL是不“等于”NULL的（控制代表一个未知的值，因此我们无法知道两个未知的数值是否相等）。</p>
<p>如果expression是行值，那么当行表达式本身为非空值或者行的所有域为非空时IS NULL为真。由于这种行为，IS NULL和IS NOT NULL并不总是为行值表达式返回反转的结果，特别是，一个同时包含 NULL 和非空值的域将会对两种测试都返回假。在某些情况下，写成row IS DISTINCT FROM NULL或者row IS NOT DISTINCT FROM NULL会更好，它们只会检查整个行值是否为空而不需要在行的域上做额外的测试。</p>
<p>布尔值也可以使用下列谓词进行测试：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="b7d203b" class="language-sql ">
  <code>boolean_expression IS TRUE
boolean_expression IS NOT TRUE
boolean_expression IS FALSE
boolean_expression IS NOT FALSE
boolean_expression IS UNKNOWN
boolean_expression IS NOT UNKNOWN</code>
  </pre>
  </div>
<p>这些谓词将总是返回真或假，从来不返回空值，即使操作数是空也如此。空值输入被当做逻辑值“未知”。 请注意实际上IS UNKNOWN和IS NOT UNKNOWN分别与IS NULL和IS NOT NULL相同， 只是输入表达式必须是布尔类型。</p>
<p>如表中所示，也有一些比较相关的函数可用。</p>
<p><strong>表.比较函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>描述</th>
<th>例子</th>
<th>例子结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>num_nonnulls(VARIADIC &ldquo;any&rdquo;)</td>
<td>返回非空参数的数量</td>
<td>num_nonnulls(1, NULL, 2)</td>
<td>2</td>
</tr>
<tr>
<td>num_nulls(VARIADIC &ldquo;any&rdquo;)</td>
<td>返回空参数的数量</td>
<td>num_nulls(1, NULL, 2)</td>
<td>1</td>
</tr>
</tbody>
</table>
</p>
<h2 id="数学函数和操作符">数学函数和操作符 <a href="#%e6%95%b0%e5%ad%a6%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>MemFireDB为很多类型提供了数学操作符。对于那些没有标准数学表达的类型（如日期/时间类型），我们将在后续小节中描述实际的行为。</p>
<h3 id="数学操作符">数学操作符 <a href="#%e6%95%b0%e5%ad%a6%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>下表展示了所有可用的数学操作符。</p>
<p><strong>表.数学操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>操作符</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>+</td>
<td>加</td>
<td>2 + 3</td>
<td>5</td>
</tr>
<tr>
<td>-</td>
<td>减</td>
<td>2 - 3</td>
<td>-1</td>
</tr>
<tr>
<td>*</td>
<td>乘</td>
<td>2 * 3</td>
<td>6</td>
</tr>
<tr>
<td>/</td>
<td>除（整数除法截断结果）</td>
<td>4 / 2</td>
<td>2</td>
</tr>
<tr>
<td>%</td>
<td>模（取余）</td>
<td>5 % 4</td>
<td>1</td>
</tr>
<tr>
<td>^</td>
<td>指数（从左至右结合）</td>
<td>2.0 ^ 3.0</td>
<td>8</td>
</tr>
<tr>
<td>|/</td>
<td>平方根</td>
<td>|/ 25.0</td>
<td>5</td>
</tr>
<tr>
<td>||/</td>
<td>立方根</td>
<td>||/ 27.0</td>
<td>3</td>
</tr>
<tr>
<td>!</td>
<td>阶乘</td>
<td>5 !</td>
<td>120</td>
</tr>
<tr>
<td>!!</td>
<td>阶乘（前缀操作符）</td>
<td>!! 5</td>
<td>120</td>
</tr>
<tr>
<td>@</td>
<td>绝对值</td>
<td>@ -5.0</td>
<td>5</td>
</tr>
<tr>
<td>&amp;</td>
<td>按位与</td>
<td>91 &amp; 15</td>
<td>11</td>
</tr>
<tr>
<td>|</td>
<td>按位或</td>
<td>32 | 3</td>
<td>35</td>
</tr>
<tr>
<td>#</td>
<td>按位异或</td>
<td>17 # 5</td>
<td>20</td>
</tr>
<tr>
<td>~</td>
<td>按位求反</td>
<td>~1</td>
<td>-2</td>
</tr>
<tr>
<td>&laquo;</td>
<td>按位左移</td>
<td>1 &laquo; 4</td>
<td>16</td>
</tr>
<tr>
<td>&raquo;</td>
<td>按位右移</td>
<td>8 &raquo; 2</td>
<td>2</td>
</tr>
</tbody>
</table>
</p>
<p>按位操作操作符只能用于整数数据类型，而其它的操作符可以用于全部数字数据类型。按位操作的操作符还可以用于位串类型bit和bit varying。</p>
<p>上表显示了可用的数学函数。在该表中，dp表示double precision。这些函数中有许多都有多种不同的形式，区别是参数不同。除非特别指明，任何特定形式的函数都返回和它的参数相同的数据类型。 处理double precision数据的函数大多数是在宿主系统的 C 库基础上实现的；因此，边界情况下的准确度和行为是根据宿主系统而变化的。</p>
<h3 id="数学函数">数学函数 <a href="#%e6%95%b0%e5%ad%a6%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p><strong>表.数学函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>abs(x)</td>
<td>（和输入相同）</td>
<td>绝对值</td>
<td>abs(-17.4)</td>
<td>17.4</td>
</tr>
<tr>
<td>cbrt(dp)</td>
<td>dp</td>
<td>立方根</td>
<td>cbrt(27.0)</td>
<td>3</td>
</tr>
<tr>
<td>ceil(dp or numeric)</td>
<td>（和输入相同）</td>
<td>不小于参数的最近的整数</td>
<td>ceil(-42.8)</td>
<td>-42</td>
</tr>
<tr>
<td>ceiling(dp or numeric)</td>
<td>（和输入相同）</td>
<td>不小于参数的最近的整数（ceil的别名）</td>
<td>ceiling(-95.3)</td>
<td>-95</td>
</tr>
<tr>
<td>degrees(dp)</td>
<td>dp</td>
<td>把弧度转为角度</td>
<td>degrees(0.5)</td>
<td>28.6478897565412</td>
</tr>
<tr>
<td>div(y numeric, x numeric)</td>
<td>numeric</td>
<td>y/x的整数商</td>
<td>div(9,4)</td>
<td>2</td>
</tr>
<tr>
<td>exp(dp or numeric)</td>
<td>（和输入相同）</td>
<td>指数</td>
<td>exp(1.0)</td>
<td>2.71828182845905</td>
</tr>
<tr>
<td>floor(dp or numeric)</td>
<td>（和输入相同）</td>
<td>不大于参数的最近的整数</td>
<td>floor(-42.8)</td>
<td>-43</td>
</tr>
<tr>
<td>ln(dp or numeric)</td>
<td>（和输入相同）</td>
<td>自然对数</td>
<td>ln(2.0)</td>
<td>0.693147180559945</td>
</tr>
<tr>
<td>log(dp or numeric)</td>
<td>（和输入相同）</td>
<td>以10为底的对数</td>
<td>log(100.0)</td>
<td>2</td>
</tr>
<tr>
<td>log(b numeric, x numeric)</td>
<td>numeric</td>
<td>以b为底的对数</td>
<td>log(2.0, 64.0)</td>
<td>6.0000000000</td>
</tr>
<tr>
<td>mod(y, x)</td>
<td>（和参数类型相同）</td>
<td>y/x的余数</td>
<td>mod(9,4)</td>
<td>1</td>
</tr>
<tr>
<td>pi()</td>
<td>dp</td>
<td>“π”常数</td>
<td>pi()</td>
<td>3.14159265358979</td>
</tr>
<tr>
<td>power(a dp, b dp)</td>
<td>dp</td>
<td>求a的b次幂</td>
<td>power(9.0, 3.0)</td>
<td>729</td>
</tr>
<tr>
<td>power(a numeric, b numeric)</td>
<td>numeric</td>
<td>求a的b次幂</td>
<td>power(9.0, 3.0)</td>
<td>729</td>
</tr>
<tr>
<td>radians(dp)</td>
<td>dp</td>
<td>把角度转为弧度</td>
<td>radians(45.0)</td>
<td>0.785398163397448</td>
</tr>
<tr>
<td>round(dp or numeric)</td>
<td>（和输入相同）</td>
<td>圆整为最接近的整数</td>
<td>round(42.4)</td>
<td>42</td>
</tr>
<tr>
<td>round(v numeric, s int)</td>
<td>numeric</td>
<td>圆整为s位小数数字</td>
<td>round(42.4382, 2)</td>
<td>42.44</td>
</tr>
<tr>
<td>scale(numeric)</td>
<td>integer</td>
<td>参数的精度（小数点后的位数）</td>
<td>scale(8.41)</td>
<td>2</td>
</tr>
<tr>
<td>sign(dp or numeric)</td>
<td>（和输入相同）</td>
<td>参数的符号（-1, 0, +1）</td>
<td>sign(-8.4)</td>
<td>-1</td>
</tr>
<tr>
<td>sqrt(dp or numeric)</td>
<td>（和输入相同）</td>
<td>平方根</td>
<td>sqrt(2.0)</td>
<td>1.4142135623731</td>
</tr>
<tr>
<td>trunc(dp or numeric)</td>
<td>（和输入相同）</td>
<td>截断（向零靠近）</td>
<td>trunc(42.8)</td>
<td>42</td>
</tr>
<tr>
<td>trunc(v numeric, s int)</td>
<td>numeric</td>
<td>截断为s位小数位置的数字</td>
<td>trunc(42.4382, 2)</td>
<td>42.43</td>
</tr>
<tr>
<td>width_bucket(op dp, b1 dp, b2 dp, count int)</td>
<td>int</td>
<td>返回一个桶号，这个桶是在一个柱状图中operand将被分配的那个桶，该柱状图有count个散布在范围b1到b2上的等宽桶。对于超过该范围的输入，将返回0或者count+1</td>
<td>width_bucket(5.35, 0.024, 10.06, 5)</td>
<td>3</td>
</tr>
<tr>
<td>width_bucket(op numeric, b1 numeric, b2 numeric, count int)</td>
<td>int</td>
<td>返回一个桶号，这个桶是在一个柱状图中operand将被分配的那个桶，该柱状图有count个散布在范围b1到b2上的等宽桶。对于超过该范围的输入，将返回0或者count+1</td>
<td>width_bucket(5.35, 0.024, 10.06, 5)</td>
<td>3</td>
</tr>
<tr>
<td>width_bucket(operand anyelement, thresholds anyarray)</td>
<td>int</td>
<td>返回一个桶号，这个桶是在给定数组中operand 将被分配的桶，该数组列出了桶的下界。对于一个低于第一个下界的输入返回 0。thresholds数组<em>必须被排好序</em>， 最小的排在最前面，否则将会得到意想不到的结果</td>
<td>width_bucket(now(), array[&lsquo;yesterday&rsquo;,  &rsquo;today&rsquo;, &rsquo;tomorrow&rsquo;]::timestamptz[])</td>
<td>2</td>
</tr>
</tbody>
</table>
</p>
<h3 id="随机函数">随机函数 <a href="#%e9%9a%8f%e6%9c%ba%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>下表展示了用于产生随机数的函数。</p>
<p><strong>表.随机函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>random()</td>
<td>dp</td>
<td>范围 0.0 &lt;= x &lt; 1.0 中的随机值</td>
</tr>
<tr>
<td>setseed(dp)</td>
<td>void</td>
<td>为后续的random()调用设置种子（值为于 -1.0 和 1.0 之间，包括边界值）</td>
</tr>
</tbody>
</table>
</p>
<p>random()返回的值的特征取决于系统实现。 它不适合用于加密应用，如果需要用于加密应用请参考pgcrypto模块。</p>
<p>最后，表显示了可用的三角函数。所有三角函数都有类型为double precision的参数和返回类型。每一种三角函数都有两个变体，一个以弧度度量角，另一个以角度度量角。</p>
<h3 id="三角函数">三角函数 <a href="#%e4%b8%89%e8%a7%92%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p><strong>表.三角函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数（弧度）</th>
<th>函数（角度）</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>acos(x)</td>
<td>acosd(x)</td>
<td>反余弦</td>
</tr>
<tr>
<td>asin(x)</td>
<td>asind(x)</td>
<td>反正弦</td>
</tr>
<tr>
<td>atan(x)</td>
<td>atand(x)</td>
<td>反正切</td>
</tr>
<tr>
<td>atan2(y, x)</td>
<td>atan2d(y, x)</td>
<td>y/x的反正切</td>
</tr>
<tr>
<td>cos(x)</td>
<td>cosd(x)</td>
<td>余弦</td>
</tr>
<tr>
<td>cot(x)</td>
<td>cotd(x)</td>
<td>余切</td>
</tr>
<tr>
<td>sin(x)</td>
<td>sind(x)</td>
<td>正弦</td>
</tr>
<tr>
<td>tan(x)</td>
<td>tand(x)</td>
<td>正切</td>
</tr>
</tbody>
</table>
</p>
<h2 id="字符串函数和操作符">字符串函数和操作符 <a href="#%e5%ad%97%e7%ac%a6%e4%b8%b2%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述了用于检查和操作字符串值的函数和操作符。在这个环境中的串包括所有类型character、character varying和text的值。除非另外说明，所有下面列出的函数都可以处理这些类型，不过要小心的是，在使用character类型的时候， 它有自动填充空白的潜在影响。有些函数还可以处理位串类型。</p>
<p>SQL定义了一些字符串函数，它们使用关键字，而不是逗号来分隔参数。MemFireDB也提供了这些函数使用正常函数调用语法的版本。</p>
<p><strong>表.SQL字符串函数和操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>string || string</td>
<td>text</td>
<td>串接</td>
<td>&lsquo;Post&rsquo; || &lsquo;greSQL&rsquo;</td>
<td>PostgreSQL</td>
</tr>
<tr>
<td>string || non-string or non-string || string</td>
<td>text</td>
<td>使用一个非字符串输入的串接</td>
<td>&lsquo;Value: &rsquo; || 42</td>
<td>Value: 42</td>
</tr>
<tr>
<td>bit_length(string)</td>
<td>int</td>
<td>串中的位数</td>
<td>bit_length(&lsquo;jose&rsquo;)</td>
<td>32</td>
</tr>
<tr>
<td>char_length(string) or character_length(string)</td>
<td>int</td>
<td>串中字符数</td>
<td>char_length(&lsquo;jose&rsquo;)</td>
<td>4</td>
</tr>
<tr>
<td>lower(string)</td>
<td>text</td>
<td>将字符串转换为小写形式</td>
<td>lower(&lsquo;TOM&rsquo;)</td>
<td>tom</td>
</tr>
<tr>
<td>octet_length(string)</td>
<td>int</td>
<td>串中的字节数</td>
<td>octet_length(&lsquo;jose&rsquo;)</td>
<td>4</td>
</tr>
<tr>
<td>overlay(string placing string from int [for int])</td>
<td>text</td>
<td>替换子串</td>
<td>overlay(&lsquo;Txxxxas&rsquo; placing &lsquo;hom&rsquo; from 2 for 4)</td>
<td>Thomas</td>
</tr>
<tr>
<td>position(substring in string)</td>
<td>int</td>
<td>定位指定子串</td>
<td>position(&lsquo;om&rsquo; in &lsquo;Thomas&rsquo;)</td>
<td>3</td>
</tr>
<tr>
<td>substring(string [from int]  [for int])</td>
<td>text</td>
<td>提取子串</td>
<td>substring(&lsquo;Thomas&rsquo; from 2 for 3)</td>
<td>hom</td>
</tr>
<tr>
<td>substring(string from pattern)</td>
<td>text</td>
<td>提取匹配POSIX正则表达式的子串。模式匹配。</td>
<td>substring(&lsquo;Thomas&rsquo; from &lsquo;&hellip;$&rsquo;)</td>
<td>mas</td>
</tr>
<tr>
<td>substring(string from pattern for escape)</td>
<td>text</td>
<td>提取匹配SQL正则表达式的子串。</td>
<td>substring(&lsquo;Thomas&rsquo; from &lsquo;%#&ldquo;o_a#&rdquo;_&rsquo;  for &lsquo;#&rsquo;)</td>
<td>oma</td>
</tr>
<tr>
<td>trim([leading | trailing | both] [characters]  from string)</td>
<td>text</td>
<td>从string的开头、结尾或者两端（both是默认值）移除只包含characters（默认是一个空格）中字符的最长字符串</td>
<td>trim(both &lsquo;xyz&rsquo; from &lsquo;yxTomxx&rsquo;)</td>
<td>Tom</td>
</tr>
<tr>
<td>trim([leading | trailing | both]  [from] string [, characters] )</td>
<td>text</td>
<td>trim()的非标准版本</td>
<td>trim(both from &lsquo;xTomxx&rsquo;, &lsquo;x&rsquo;)</td>
<td>Tom</td>
</tr>
<tr>
<td>upper(string)</td>
<td>text</td>
<td>将字符串转换成大写形式</td>
<td>upper(&rsquo;tom&rsquo;)</td>
<td>TOM</td>
</tr>
</tbody>
</table>
</p>
<p>还有额外的串操作函数可以用，它们在下表中列出。它们有些在内部用于实现表 列出的SQL标准字符串函数。</p>
<p><strong>表.其他字符串函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>ascii(string)</td>
<td>int</td>
<td>参数第一个字符的ASCII代码。对于UTF8返回该字符的Unicode代码点。对于其他多字节编码，该参数必须是一个ASCII字符。</td>
<td>ascii(&lsquo;x&rsquo;)</td>
<td>120</td>
</tr>
<tr>
<td>btrim(string text [, characters text])</td>
<td>text</td>
<td>从string的开头或结尾删除最长的只包含characters（默认是一个空格）的串</td>
<td>btrim(&lsquo;xyxtrimyyx&rsquo;, &lsquo;xyz&rsquo;)</td>
<td>trim</td>
</tr>
<tr>
<td>chr(int)</td>
<td>text</td>
<td>给定代码的字符。对于UTF8该参数被视作一个Unicode代码点。对于其他多字节编码该参数必须指定一个ASCII字符。NULL (0) 字符不被允许，因为文本数据类型不能存储这种字节。</td>
<td>chr(65)</td>
<td>A</td>
</tr>
<tr>
<td>concat(str &ldquo;any&rdquo; [, str &ldquo;any&rdquo; [,  &hellip;] ])</td>
<td>text</td>
<td>串接所有参数的文本表示。NULL 参数被忽略。</td>
<td>concat(&lsquo;abcde&rsquo;, 2, NULL, 22)</td>
<td>abcde222</td>
</tr>
<tr>
<td>concat_ws(sep text, str &ldquo;any&rdquo; [, str &ldquo;any&rdquo; [,  &hellip;] ])</td>
<td>text</td>
<td>将除了第一个参数外的其他参数用分隔符串接在一起。第一个参数被用作分隔符字符串。NULL 参数被忽略。</td>
<td>concat_ws(&rsquo;,&rsquo;, &lsquo;abcde&rsquo;, 2, NULL, 22)</td>
<td>abcde,2,22</td>
</tr>
<tr>
<td>decode(string text, format text)</td>
<td>bytea</td>
<td>从string中的文本表达解码二进制数据。format的选项和encode中的一样。</td>
<td>decode(&lsquo;MTIzAAE=&rsquo;, &lsquo;base64&rsquo;)</td>
<td>\x3132330001</td>
</tr>
<tr>
<td>encode(data bytea, format text)</td>
<td>text</td>
<td>将二进制数据编码成一个文本表达。支持的格式有：base64、hex、escape。escape将零字节和高位组字节转换为八进制序列（\nnn）和双写的反斜线。</td>
<td>encode(&lsquo;123\000\001&rsquo;, &lsquo;base64&rsquo;)</td>
<td>MTIzAAE=</td>
</tr>
<tr>
<td>format(formatstr text [, formatarg &ldquo;any&rdquo; [,  &hellip;] ])</td>
<td>text</td>
<td>根据一个格式字符串格式化参数。该函数和C函数sprintf相似。</td>
<td>format(&lsquo;Hello %s, %1$s&rsquo;, &lsquo;World&rsquo;)</td>
<td>Hello World, World</td>
</tr>
<tr>
<td>initcap(string)</td>
<td>text</td>
<td>将每一个词的第一个字母转换为大写形式并把剩下的字母转换为小写形式。词是由非字母数字字符分隔的字母数字字符的序列。</td>
<td>initcap(&lsquo;hi THOMAS&rsquo;)</td>
<td>Hi Thomas</td>
</tr>
<tr>
<td>left(str text, n int)</td>
<td>text</td>
<td>返回字符串中的前n个字符。当n为负时，将返回除了最后|n|个字符之外的所有字符。</td>
<td>left(&lsquo;abcde&rsquo;, 2)</td>
<td>ab</td>
</tr>
<tr>
<td>length(string)</td>
<td>int</td>
<td>string中的字符数</td>
<td>length(&lsquo;jose&rsquo;)</td>
<td>4</td>
</tr>
<tr>
<td>length(string bytea, encoding name )</td>
<td>int</td>
<td>string在给定编码中的字符数。string必须在这个编码中有效。</td>
<td>length(&lsquo;jose&rsquo;, &lsquo;UTF8&rsquo;)</td>
<td>4</td>
</tr>
<tr>
<td>lpad(string text, length int [, fill text])</td>
<td>text</td>
<td>将string通过前置字符fill（默认是一个空格）填充到长度length。如果string已经长于length，则它被（从右边）截断。</td>
<td>lpad(&lsquo;hi&rsquo;, 5, &lsquo;xy&rsquo;)</td>
<td>xyxhi</td>
</tr>
<tr>
<td>ltrim(string text [, characters text])</td>
<td>text</td>
<td>从string的开头删除最长的只包含characters（默认是一个空格）的串</td>
<td>ltrim(&lsquo;zzzytest&rsquo;, &lsquo;xyz&rsquo;)</td>
<td>test</td>
</tr>
<tr>
<td>md5(string)</td>
<td>text</td>
<td>计算string的 MD5 哈希，返回十六进制的结果</td>
<td>md5(&lsquo;abc&rsquo;)</td>
<td>900150983cd24fb0 d6963f7d28e17f72</td>
</tr>
<tr>
<td>parse_ident(qualified_identifier text [, strictmode boolean DEFAULT  true ] )</td>
<td>text[]</td>
<td>把qualified_identifier分成一个标识符数组，移除单个标识符上的任何引号。默认情况下，最后一个标识符后面的多余字符会被当做错误。但是如果第二个参数为false，那么这一类多余的字符会被忽略（这种行为对于解析函数之类的对象名称有用）。注意这个函数不会截断超长标识符。如果想要进行截断，可以把结果转换成name[]。</td>
<td>parse_ident(&rsquo;&ldquo;SomeSchema&rdquo;.someTable&rsquo;)</td>
<td>{SomeSchema,sometable}</td>
</tr>
<tr>
<td>pg_client_encoding()</td>
<td>name</td>
<td>当前的客户端编码名字</td>
<td>pg_client_encoding()</td>
<td>SQL_ASCII</td>
</tr>
<tr>
<td>quote_ident(string text)</td>
<td>text</td>
<td>将给定字符串返回成合适的引用形式，使它可以在一个SQL语句字符串中被用作一个标识符。只有需要时才会加上引号（即，如果字符串包含非标识符字符或可能是大小写折叠的）。嵌入的引号会被正确地双写。</td>
<td>quote_ident(&lsquo;Foo bar&rsquo;)</td>
<td>&ldquo;Foo bar&rdquo;</td>
</tr>
<tr>
<td>quote_literal(string text)</td>
<td>text</td>
<td>将给定字符串返回成合适的引用形式，使它可以在一个SQL语句字符串中被用作一个字符串文字。嵌入的引号会被正确地双写。注意quote_literal对空输入返回空；如果参数可能为空，quote_nullable通常更合适。</td>
<td>quote_literal(E&rsquo;O'Reilly&rsquo;)</td>
<td>&lsquo;O&rsquo;&lsquo;Reilly&rsquo;</td>
</tr>
<tr>
<td>quote_literal(value anyelement)</td>
<td>text</td>
<td>强迫给定值为文本并且接着将它用引号包围作为一个文本。嵌入的单引号和反斜线被正确的双写。</td>
<td>quote_literal(42.5)</td>
<td>&lsquo;42.5&rsquo;</td>
</tr>
<tr>
<td>quote_nullable(string text)</td>
<td>text</td>
<td>将给定字符串返回成合适的引用形式，使它可以在一个SQL语句字符串中被用作一个字符串文字；或者，如果参数为空，返回NULL。嵌入的引号会被正确地双写。</td>
<td>quote_nullable(NULL)</td>
<td>NULL</td>
</tr>
<tr>
<td>quote_nullable(value anyelement)</td>
<td>text</td>
<td>强迫给定值为文本并且接着将它用引号包围作为一个文本；或者，如果参数为空，返回NULL。嵌入的单引号和反斜线被正确的双写。</td>
<td>quote_nullable(42.5)</td>
<td>&lsquo;42.5&rsquo;</td>
</tr>
<tr>
<td>regexp_match(string text, pattern text [, flags text])</td>
<td>text[]</td>
<td>返回一个POSIX正则表达式与string的第一个匹配得到的子串。</td>
<td>regexp_match(&lsquo;foobarbequebaz&rsquo;,  &lsquo;(bar)(beque)&rsquo;)</td>
<td>{bar,beque}</td>
</tr>
<tr>
<td>regexp_matches(string text, pattern text [, flags text])</td>
<td>setof text[]</td>
<td>返回一个POSIX正则表达式与string匹配得到的子串。</td>
<td>regexp_matches(&lsquo;foobarbequebaz&rsquo;, &lsquo;ba.&rsquo;, &lsquo;g&rsquo;)</td>
<td>{bar}  {baz}  (2 rows)</td>
</tr>
<tr>
<td>regexp_replace(string text, pattern text, replacement text [, flags text])</td>
<td>text</td>
<td>替换匹配一个POSIX正则表达式的子串。</td>
<td>regexp_replace(&lsquo;Thomas&rsquo;, &lsquo;.[mN]a.&rsquo;, &lsquo;M&rsquo;)</td>
<td>ThM</td>
</tr>
<tr>
<td>regexp_split_to_array(string text, pattern text [, flags text ])</td>
<td>text[]</td>
<td>使用一个POSIX正则表达式作为分隔符划分string。</td>
<td>regexp_split_to_array(&lsquo;hello world&rsquo;, &lsquo;\s+&rsquo;)</td>
<td>{hello,world}</td>
</tr>
<tr>
<td>regexp_split_to_table(string text, pattern text [, flags text])</td>
<td>setof text</td>
<td>使用一个POSIX正则表达式作为分隔符划分string。</td>
<td>regexp_split_to_table(&lsquo;hello world&rsquo;, &lsquo;\s+&rsquo;)</td>
<td>hello  world  (2 rows)</td>
</tr>
<tr>
<td>repeat(string text, number int)</td>
<td>text</td>
<td>重复string指定的number次</td>
<td>repeat(&lsquo;Pg&rsquo;, 4)</td>
<td>PgPgPgPg</td>
</tr>
<tr>
<td>replace(string text, from text, to text)</td>
<td>text</td>
<td>将string中出现的所有子串from替换为子串to</td>
<td>replace(&lsquo;abcdefabcdef&rsquo;, &lsquo;cd&rsquo;, &lsquo;XX&rsquo;)</td>
<td>abXXefabXXef</td>
</tr>
<tr>
<td>reverse(str)</td>
<td>text</td>
<td>返回反转的字符串。</td>
<td>reverse(&lsquo;abcde&rsquo;)</td>
<td>edcba</td>
</tr>
<tr>
<td>right(str text, n int)</td>
<td>text</td>
<td>返回字符串中的最后n个字符。如果n为负，返回除最前面的|n|个字符外的所有字符。</td>
<td>right(&lsquo;abcde&rsquo;, 2)</td>
<td>de</td>
</tr>
<tr>
<td>rpad(string text, length int [, fill text])</td>
<td>text</td>
<td>将string通过增加字符fill（默认为一个空格）填充到长度length。如果string已经长于length则它会被截断。</td>
<td>rpad(&lsquo;hi&rsquo;, 5, &lsquo;xy&rsquo;)</td>
<td>hixyx</td>
</tr>
<tr>
<td>rtrim(string text [, characters text])</td>
<td>text</td>
<td>从string的结尾删除最长的只包含characters（默认是一个空格）的串</td>
<td>rtrim(&rsquo;testxxzx&rsquo;, &lsquo;xyz&rsquo;)</td>
<td>test</td>
</tr>
<tr>
<td>split_part(string text, delimiter text, field int)</td>
<td>text</td>
<td>按delimiter划分string并返回给定域（从1开始计算）</td>
<td>split_part(&lsquo;abc~@~def~@~ghi&rsquo;, &lsquo;~@~&rsquo;, 2)</td>
<td>def</td>
</tr>
<tr>
<td>strpos(string, substring)</td>
<td>int</td>
<td>指定子串的位置（和position(substring in string)相同，但是注意相反的参数顺序）</td>
<td>strpos(&lsquo;high&rsquo;, &lsquo;ig&rsquo;)</td>
<td>2</td>
</tr>
<tr>
<td>substr(string, from [, count])</td>
<td>text</td>
<td>提取子串（与substring(string from from for count)相同）</td>
<td>substr(&lsquo;alphabet&rsquo;, 3, 2)</td>
<td>ph</td>
</tr>
<tr>
<td>starts_with(string, prefix)</td>
<td>bool</td>
<td>如果string以prefix开始则返回真。</td>
<td>starts_with(&lsquo;alphabet&rsquo;, &lsquo;alph&rsquo;)</td>
<td>t</td>
</tr>
<tr>
<td>to_hex(number int or bigint)</td>
<td>text</td>
<td>将number转换到它等效的十六进制表示</td>
<td>to_hex(2147483647)</td>
<td>7fffffff</td>
</tr>
<tr>
<td>translate(string text, from text, to text)</td>
<td>text</td>
<td>string中任何匹配from集合中一个字符的字符会被替换成to集合中的相应字符。如果from比to长，from中的额外字符会被删除。</td>
<td>translate(&lsquo;12345&rsquo;, &lsquo;143&rsquo;, &lsquo;ax&rsquo;)</td>
<td>a2x5</td>
</tr>
</tbody>
</table>
</p>
<p>concat、concat_ws和format函数是可变的，因此可以把要串接或格式化的值作为一个标记了VARIADIC关键字的数组进行传递。数组的元素被当作函数的独立普通参数一样处理。如果可变数组参数为 NULL，concat和concat_ws返回 NULL，但format把 NULL 当作一个零元素数组。</p>
<p><strong>format</strong></p>
<p>函数format根据一个格式字符串产生格式化的输出，其形式类似于 C 函数sprintf。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="40b8f05" class="language- ">
  <code>format(formatstr text [, formatarg &#34;any&#34; [, ...] ])</code>
  </pre>
  </div>
<p>formatstr是一个格式字符串，它指定了结果应该如何被格式化。格式字符串中的文本被直接复制到结果中，除了使用格式说明符的地方。格式说明符在字符串中扮演着占位符的角色，它定义后续的函数参数如何被格式化及插入到结果中。每一个formatarg参数会被根据其数据类型的常规输出规则转换为文本，并接着根据格式说明符被格式化和插入到结果字符串中。</p>
<p>格式说明符由一个%字符开始并且有这样的形式</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4ab43de" class="language- ">
  <code>%[position][flags][width]type</code>
  </pre>
  </div>
<p>其中的各组件域是：</p>
<p><strong>position</strong>（可选）</p>
<p>一个形式为n$的字符串，其中n是要打印的参数的索引。索引 1 表示formatstr之后的第一个参数。如果position被忽略，默认会使用序列中的下一个参数。</p>
<p>flags（可选）</p>
<p>控制格式说明符的输出如何被格式化的附加选项。当前唯一支持的标志是一个负号（-），它将导致格式说明符的输出会被左对齐（left-justified）。除非width域也被指定，否者这个域不会产生任何效果。</p>
<p>width（可选）</p>
<p>指定用于显示格式说明符输出的最小字符数。输出将被在左部或右部（取决于-标志）用空格填充以保证充满该宽度。太小的宽度设置不会导致输出被截断，但是会被简单地忽略。宽度可以使用下列形式之一指定：一个正整数；一个星号（<em>）表示使用下一个函数参数作为宽度；或者一个形式为</em>n$的字符串表示使用第n个函数参数作为宽度。</p>
<p>如果宽度来自于一个函数参数，则参数在被格式说明符的值使用之前就被消耗掉了。如果宽度参数是负值，结果会在长度为abs(width)的域中被左对齐（如果-标志被指定）。</p>
<p>type（必需）</p>
<p>格式转换的类型，用于产生格式说明符的输出。支持下面的类型：</p>
<p>·   s将参数值格式化为一个简单字符串。一个控制被视为一个空字符串。</p>
<p>·   I将参数值视作 SQL 标识符，并在必要时用双写引号包围它。如果参数为空，将会是一个错误（等效于quote_ident）。</p>
<p>·   L将参数值引用为 SQL 文字。一个空值将被显示为不带引号的字符串NULL（等效于quote_nullable）。</p>
<p>除了以上所述的格式说明符之外，要输出一个文字形式的%字符，可以使用特殊序列%%。</p>
<p>下面有一些基本的格式转换的例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2647366" class="language- ">
  <code>SELECT format(&#39;Hello %s&#39;, &#39;World&#39;);
结果：Hello World
 
SELECT format(&#39;Testing %s, %s, %s, %%&#39;, &#39;one&#39;, &#39;two&#39;, &#39;three&#39;);
结果：Testing one, two, three, %
 
SELECT format(&#39;INSERT INTO %I VALUES(%L)&#39;, &#39;Foo bar&#39;, E&#39;O\&#39;Reilly&#39;);
结果：INSERT INTO &#34;Foo bar&#34; VALUES(&#39;O&#39;&#39;Reilly&#39;)
 
SELECT format(&#39;INSERT INTO %I VALUES(%L)&#39;, &#39;locations&#39;, &#39;C:\Program Files&#39;);
结果：INSERT INTO locations VALUES(E&#39;C:\\Program Files&#39;)</code>
  </pre>
  </div>
<p>下面是使用width域和-标志的例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="b1d500b" class="language- ">
  <code>SELECT format(&#39;|%10s|&#39;, &#39;foo&#39;);
结果：|       foo|
 
SELECT format(&#39;|%-10s|&#39;, &#39;foo&#39;);
结果：|foo       |
 
SELECT format(&#39;|%*s|&#39;, 10, &#39;foo&#39;);
结果：|       foo|
 
SELECT format(&#39;|%*s|&#39;, -10, &#39;foo&#39;);
结果：|foo       |
 
SELECT format(&#39;|%-*s|&#39;, 10, &#39;foo&#39;);
结果：|foo       |
 
SELECT format(&#39;|%-*s|&#39;, -10, &#39;foo&#39;);
结果：|foo       |</code>
  </pre>
  </div>
<p>这些例子展示了position域的例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="57ffc0c" class="language- ">
  <code>SELECT format(&#39;Testing %3$s, %2$s, %1$s&#39;, &#39;one&#39;, &#39;two&#39;, &#39;three&#39;);
结果：Testing three, two, one
 
SELECT format(&#39;|%*2$s|&#39;, &#39;foo&#39;, 10, &#39;bar&#39;);
结果：|       bar|
 
SELECT format(&#39;|%1$*2$s|&#39;, &#39;foo&#39;, 10, &#39;bar&#39;);
结果：|       foo|</code>
  </pre>
  </div>
<p>不同于标准的 C 函数sprintf，PostgreSQL的format函数允许将带有或者不带有position域的格式说明符被混在同一个格式字符串中。一个不带有position域的格式说明符总是使用最后一个被消耗的参数的下一个参数。另外，format函数不要求所有函数参数都被用在格式字符串中。例如：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e5e319c" class="language- ">
  <code>SELECT format(&#39;Testing %3$s, %2$s, %s&#39;, &#39;one&#39;, &#39;two&#39;, &#39;three&#39;);
结果：Testing three, two, three</code>
  </pre>
  </div>
<p>对于安全地构造动态 SQL 语句，%I和%L格式说明符特别有用。</p>
<h2 id="二进制串函数与操作符">二进制串函数与操作符 <a href="#%e4%ba%8c%e8%bf%9b%e5%88%b6%e4%b8%b2%e5%87%bd%e6%95%b0%e4%b8%8e%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述那些检查和操作类型为bytea的值的函数和操作符。</p>
<p>SQL定义了一些使用关键字而不是逗号来分割参数的串函数。</p>
<p><strong>表.SQL二进制串函数和操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>string || string</td>
<td>bytea</td>
<td>串连接</td>
<td>&lsquo;\Post&rsquo;::bytea || &lsquo;\047gres\000&rsquo;::bytea</td>
<td>\Post&rsquo;gres\000</td>
</tr>
<tr>
<td>octet_length(string)</td>
<td>int</td>
<td>二进制串中的字节数</td>
<td>octet_length(&lsquo;jo\000se&rsquo;::bytea)</td>
<td>5</td>
</tr>
<tr>
<td>overlay(string placing string from int [for int])</td>
<td>bytea</td>
<td>替换子串</td>
<td>overlay(&lsquo;Th\000omas&rsquo;::bytea placing  &lsquo;\002\003&rsquo;::bytea from 2 for 3)</td>
<td>T\002\003mas</td>
</tr>
<tr>
<td>position(substring in string)</td>
<td>int</td>
<td>指定子串的位置</td>
<td>position(&rsquo;\000om&rsquo;::bytea in  &lsquo;Th\000omas&rsquo;::bytea)</td>
<td>3</td>
</tr>
<tr>
<td>substring(string [from int]  [for int])</td>
<td>bytea</td>
<td>提取子串</td>
<td>substring(&lsquo;Th\000omas&rsquo;::bytea from 2 for 3)</td>
<td>h\000o</td>
</tr>
<tr>
<td>trim([both] bytes from string)</td>
<td>bytea</td>
<td>从string的开头或结尾删除只包含出现在bytes中字节的最长串</td>
<td>trim(&rsquo;\000\001&rsquo;::bytea from  &lsquo;\000Tom\001&rsquo;::bytea)</td>
<td>Tom</td>
</tr>
</tbody>
</table>
</p>
<p>还有一些二进制串处理函数可以使用，在下表列出。</p>
<p><strong>表 . 其他二进制串函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>btrim(string bytea, bytes bytea)</td>
<td>bytea</td>
<td>从string的开头或结尾删除只由出现在bytes中字节组成的最长串</td>
<td>btrim(&rsquo;\000trim\001&rsquo;::bytea,  &lsquo;\000\001&rsquo;::bytea)</td>
<td>trim</td>
</tr>
<tr>
<td>decode(string text, format text)</td>
<td>bytea</td>
<td>从string中的文本表示解码二进制数据。format的参数和在encode中一样。</td>
<td>decode(&lsquo;123\000456&rsquo;, &rsquo;escape&rsquo;)</td>
<td>123\000456</td>
</tr>
<tr>
<td>encode(data bytea, format text)</td>
<td>text</td>
<td>将二进制数据编码为一个文本表示。支持的格式有：base64、hex、escape。escape将零字节和高位组字节转换为八进制序列（\nnn）和双反斜线。</td>
<td>encode(&lsquo;123\000456&rsquo;::bytea, &rsquo;escape&rsquo;)</td>
<td>123\000456</td>
</tr>
<tr>
<td>get_bit(string, offset)</td>
<td>int</td>
<td>从串中抽取位</td>
<td>get_bit(&lsquo;Th\000omas&rsquo;::bytea, 45)</td>
<td>1</td>
</tr>
<tr>
<td>get_byte(string, offset)</td>
<td>int</td>
<td>从串中抽取字节</td>
<td>get_byte(&lsquo;Th\000omas&rsquo;::bytea, 4)</td>
<td>109</td>
</tr>
<tr>
<td>length(string)</td>
<td>int</td>
<td>二进制串的长度</td>
<td>length(&lsquo;jo\000se&rsquo;::bytea)</td>
<td>5</td>
</tr>
<tr>
<td>md5(string)</td>
<td>text</td>
<td>计算string的MD5哈希码，以十六进制形式返回结果</td>
<td>md5(&lsquo;Th\000omas&rsquo;::bytea)</td>
<td>8ab2d3c9689aaf18b4958c334c82d8b1</td>
</tr>
<tr>
<td>set_bit(string, offset, newvalue)</td>
<td>bytea</td>
<td>设置串中的位</td>
<td>set_bit(&lsquo;Th\000omas&rsquo;::bytea, 45, 0)</td>
<td>Th\000omAs</td>
</tr>
<tr>
<td>set_byte(string, offset, newvalue)</td>
<td>bytea</td>
<td>设置串中的字节</td>
<td>set_byte(&lsquo;Th\000omas&rsquo;::bytea, 4, 64)</td>
<td>Th\000o@as</td>
</tr>
<tr>
<td>sha224(bytea)</td>
<td>bytea</td>
<td>SHA-224哈希</td>
<td>sha224(&lsquo;abc&rsquo;)</td>
<td>\x23097d223405d8228642a477bda255b32aadbce4bda0b3f7e36c9da7</td>
</tr>
<tr>
<td>sha256(bytea)</td>
<td>bytea</td>
<td>SHA-256哈希</td>
<td>sha256(&lsquo;abc&rsquo;)</td>
<td>\xba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad</td>
</tr>
<tr>
<td>sha384(bytea)</td>
<td>bytea</td>
<td>SHA-384哈希</td>
<td>sha384(&lsquo;abc&rsquo;)</td>
<td>\xcb00753f45a35e8bb5a03d699ac65007272c32ab0eded1631a8b605a43ff5bed8086072ba1e7cc2358baeca134c825a7</td>
</tr>
<tr>
<td>sha512(bytea)</td>
<td>bytea</td>
<td>SHA-512哈希</td>
<td>sha512(&lsquo;abc&rsquo;)</td>
<td>\xddaf35a193617abacc417349ae20413112e6fa4e89a97ea20a9eeee64b55d39a2192992a274fc1a836ba3c23a3feebbd454d4423643ce80e2a9ac94fa54ca49f</td>
</tr>
</tbody>
</table>
</p>
<p>get_byte和set_byte把一个二进制串中的一个字节计数为字节 0。get_bit和set_bit在每一个字节中从右边起计数位；例如位 0 是第一个字节的最低有效位，而位 15 是第二个字节的最高有效位。</p>
<p>注意由于历史原因，函数md5返回的是一个十六进制编码的text值，而SHA-2函数返回类型bytea。可以使用函数encode和decode在两者之间转换，例如encode(sha256(&lsquo;abc&rsquo;), &lsquo;hex&rsquo;)可以得到一个十六进制编码的文本表示。</p>
<h2 id="位串函数和操作符">位串函数和操作符 <a href="#%e4%bd%8d%e4%b8%b2%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述用于检查和操作位串的函数和操作符，也就是操作类型为bit和bit varying的值的函数和操作符。除了常用的比较操作符之外，还可以使用表里显示的操作符。&amp;、|和#的位串操作数必须等长。在移位的时候，保留原始的位串的的长度，如例子所示。</p>
<p><strong>表</strong> <strong>位串操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>操作符</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>||</td>
<td>连接</td>
<td>B'10001&rsquo; || B'011'</td>
<td>10001011</td>
</tr>
<tr>
<td>&amp;</td>
<td>按位与</td>
<td>B'10001&rsquo; &amp; B'01101'</td>
<td>00001</td>
</tr>
<tr>
<td>|</td>
<td>按位或</td>
<td>B'10001&rsquo; | B'01101'</td>
<td>11101</td>
</tr>
<tr>
<td>#</td>
<td>按位异或</td>
<td>B'10001&rsquo; # B'01101'</td>
<td>11100</td>
</tr>
<tr>
<td>~</td>
<td>按位求反</td>
<td>~ B'10001'</td>
<td>01110</td>
</tr>
<tr>
<td>&laquo;</td>
<td>按位左移</td>
<td>B'10001&rsquo; &laquo; 3</td>
<td>01000</td>
</tr>
<tr>
<td>&raquo;</td>
<td>按位右移</td>
<td>B'10001&rsquo; &raquo; 2</td>
<td>00100</td>
</tr>
</tbody>
</table>
</p>
<p>下面的SQL标准函数除了可以用于字符串之外，也可以用于位串： length、 bit_length、 octet_length、 position、 substring、 overlay。</p>
<p>下面的函数除了可以用于二进制串之外，也可以用于位串： get_bit、 set_bit。 当使用于一个位串时，这些函数将串的第一（最左）位计数为位 0。</p>
<p>另外，我们可以在整数和bit之间来回转换。一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="52c3ae9" class="language- ">
  <code>44::bit(10)                    0000101100
44::bit(3)                     100
cast(-44 as bit(12))           111111010100
&#39;1110&#39;::bit(4)::integer        14</code>
  </pre>
  </div>
<p>请注意，如果只是转换为“bit”，意思是转换成bit(1)，因此只会转换整数的最低有效位。</p>
<h2 id="模式匹配">模式匹配 <a href="#%e6%a8%a1%e5%bc%8f%e5%8c%b9%e9%85%8d" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>MemFireDB提供了三种独立的实现模式匹配的方法：SQL LIKE操作符、更近一些的SIMILAR TO操作符（SQL:1999 里添加进来的）和POSIX-风格的正则表达式。除了这些基本的“这个串匹配这个模式吗？”操作符外，还有一些函数可用于提取或替换匹配子串并在匹配位置分离一个串。</p>
<h3 id="like">LIKE <a href="#like" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="933fb23" class="language- ">
  <code>string LIKE pattern [ESCAPE escape-character]
string NOT LIKE pattern [ESCAPE escape-character]</code>
  </pre>
  </div>
<p>如果该string匹配了提供的pattern，那么LIKE表达式返回真（和预期的一样，如果LIKE返回真，那么NOT LIKE表达式返回假， 反之亦然。一个等效的表达式是NOT (string LIKE pattern)）。</p>
<p>如果pattern不包含百分号或者下划线，那么该模式只代表它本身的串；这时候LIKE的行为就象等号操作符。在pattern里的下划线 （_）代表（匹配）任何单个字符； 而一个百分号（%）匹配任何零或更多个字符的序列。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="7c68f91" class="language- ">
  <code>&#39;abc&#39; LIKE &#39;abc&#39;    true
&#39;abc&#39; LIKE &#39;a%&#39;     true
&#39;abc&#39; LIKE &#39;_b_&#39;    true
&#39;abc&#39; LIKE &#39;c&#39;      false</code>
  </pre>
  </div>
<p>LIKE模式匹配总是覆盖整个串。因此，要匹配在串内任何位置的序列，该模式必须以百分号开头和结尾。</p>
<p>要匹配文本的下划线或者百分号，而不是匹配其它字符， 在pattern里相应的字符必须 前导逃逸字符。缺省的逃逸字符是反斜线，但是你可以用ESCAPE子句指定一个不同的逃逸字符。 要匹配逃逸字符本身，写两个逃逸字符。</p>
<p>请注意反斜线在串文本里已经有特殊含义了，所以如果你写一个 包含反斜线的模式常量，那你就要在 SQL 语句里写两个反斜线。 因此，写一个匹配单个反斜线的模式实际上要在语句里写四个反斜线。 你可以通过用 ESCAPE 选择一个不同的逃逸字符 来避免这样；这样反斜线就不再是 LIKE 的特殊字符了。 但仍然是字符文本分析器的特殊字符，所以你还是需要两个反斜线。) 我们也可以通过写ESCAPE &lsquo;&lsquo;的方式不选择逃逸字符，这样可以有效地禁用逃逸机制，但是没有办法关闭下划线和百分号在模式中的特殊含义。</p>
<p>关键字ILIKE可以用于替换LIKE， 它令该匹配根据活动区域成为大小写无关。这个不属于SQL标准而是一个PostgreSQL扩展。</p>
<p>操作符<del>等效于LIKE， 而</del>*对应ILIKE。 还有 !<del>和!</del>*操作符分别代表NOT LIKE和NOT ILIKE。所有这些操作符都是PostgreSQL特有的。</p>
<p>在仅需要从字符串的开始部分搜索的情况，还有前缀操作符^@和相应的starts_with函数可以使用。</p>
<h3 id="similar-to正则表达式">SIMILAR TO正则表达式 <a href="#similar-to%e6%ad%a3%e5%88%99%e8%a1%a8%e8%be%be%e5%bc%8f" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="353cee1" class="language- ">
  <code>string SIMILAR TO pattern [ESCAPE escape-character]
string NOT SIMILAR TO pattern [ESCAPE escape-character]</code>
  </pre>
  </div>
<p>SIMILAR TO操作符根据自己的模式是否匹配给定串而返回真或者假。 它和LIKE非常类似，只不过它使用 SQL 标准定义的正则表达式理解模式。 SQL 正则表达式是在LIKE标记和普通的正则表达式标记的奇怪的杂交。</p>
<p>类似LIKE，SIMILAR TO操作符只有在它的模式匹配整个串的时候才能成功；这一点和普通的 正则表达式的行为不同，在普通的正则表达式里，模式匹配串的任意部分。 和LIKE类似的地方还有，SIMILAR TO使用_和%作为分别代表任意单个字符和任意串的通配符（这些可以比得上 POSIX 正则表达式里的.和.*）。</p>
<p>除了这些从LIKE借用的功能之外，SIMILAR TO支持下面这些从 POSIX 正则表达式借用的 模式匹配元字符：</p>
<p>·   |表示选择（两个候选之一）。</p>
<p>·   *表示重复前面的项零次或更多次。</p>
<p>·   +表示重复前面的项一次或更多次。</p>
<p>·   ?表示重复前面的项零次或一次。</p>
<p>·   {m}表示重复前面的项刚好m次。</p>
<p>·   {m,}表示重复前面的项m次或更多次。</p>
<p>·   {m,n}表示重复前面的项至少m次并且不超过n次。</p>
<p>·   可以使用圆括号()把多个项组合成一个逻辑项。</p>
<p>·   一个方括号表达式[&hellip;]声明一个字符类，就像 POSIX 正则表达式一样。</p>
<p>注意点号（.）不是SIMILAR TO的一个元字符。</p>
<p>和LIKE一样，反斜线禁用所有这些元字符的特殊含义；当然我们也可以用ESCAPE指定一个不同的逃逸字符。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e4f8bcc" class="language- ">
  <code>&#39;abc&#39; SIMILAR TO &#39;abc&#39;      true
&#39;abc&#39; SIMILAR TO &#39;a&#39;        false
&#39;abc&#39; SIMILAR TO &#39;%(b|d)%&#39;  true
&#39;abc&#39; SIMILAR TO &#39;(b|c)%&#39;   false</code>
  </pre>
  </div>
<p>带三个参数的substring，即substring(string from pattern for escape-character)，提供了抽取一个匹配 SQL 正则表达式的子串的方法。和SIMILAR TO一样，声明的模式必须匹配整个数据串，否则函数失败并返回空值。为了标识在成功的时候应该返回的模式部分，模式 必须包含逃逸字符的两次出现，并且后面要跟上双引号（&quot;）。匹配这两个标记之间的模式的文本将被返回。</p>
<p>一些例子，使用#&ldquo;定界返回串：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2cf2438" class="language- ">
  <code>substring(&#39;foobar&#39; from &#39;%#&#34;o_b#&#34;%&#39; for &#39;#&#39;)   oob
substring(&#39;foobar&#39; from &#39;#&#34;o_b#&#34;%&#39; for &#39;#&#39;)    NULL</code>
  </pre>
  </div>
<h3 id="posix正则表达式">POSIX正则表达式 <a href="#posix%e6%ad%a3%e5%88%99%e8%a1%a8%e8%be%be%e5%bc%8f" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>下表列出了所有可用于 POSIX 正则表达式模式匹配的操作符。</p>
<p><strong>表 正则表达式匹配操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>操作符</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>~</td>
<td>匹配正则表达式，大小写敏感</td>
<td>&rsquo;thomas&rsquo; ~ &lsquo;.<em>thomas.</em>&rsquo;</td>
</tr>
<tr>
<td>~*</td>
<td>匹配正则表达式，大小写不敏感</td>
<td>&rsquo;thomas&rsquo; ~* &lsquo;.<em>Thomas.</em>&rsquo;</td>
</tr>
<tr>
<td>!~</td>
<td>不匹配正则表达式，大小写敏感</td>
<td>&rsquo;thomas&rsquo; !~ &lsquo;.<em>Thomas.</em>&rsquo;</td>
</tr>
<tr>
<td>!~*</td>
<td>不匹配正则表达式，大小写不敏感</td>
<td>&rsquo;thomas&rsquo; !~* &lsquo;.<em>vadim.</em>&rsquo;</td>
</tr>
</tbody>
</table>
</p>
<p>POSIX正则表达式提供了比LIKE和SIMILAR TO操作符更强大的含义。许多 Unix 工具，例如egrep、sed或awk使用一种与我们这里描述的类似的模式匹配语言。</p>
<p>正则表达式是一个字符序列，它是定义一个串集合 （一个正则集）的缩写。 如果一个串是正则表达式描述的正则集中的一员时， 我们就说这个串匹配该正则表达式。 和LIKE一样，模式字符准确地匹配串字符， 除非在正则表达式语言里有特殊字符 — 不过正则表达式用的 特殊字符和LIKE用的不同。 和LIKE模式不一样的是，正则表达式允许匹配串里的任何位置，除非该正则表达式显式地挂接在串的开头或者结尾。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="98be289" class="language- ">
  <code>&#39;abc&#39; ~ &#39;abc&#39;    true
&#39;abc&#39; ~ &#39;^a&#39;     true
&#39;abc&#39; ~ &#39;(b|d)&#39;  true
&#39;abc&#39; ~ &#39;^(b|c)&#39; false</code>
  </pre>
  </div>
<p>POSIX模式语言的详细描述见下文。</p>
<p>带两个参数的substring函数，即<strong>substring(string from pattern)</strong>，提供了抽取一个匹配 POSIX 正则表达式模式的子串的方法。如果没有匹配它返回空值，否则就是文本中匹配模式的那部分。 但是如果该模式包含任何圆括号，那么将返回匹配第一对子表达式（对应第一个左圆括号的） 的文本。如果你想在表达式里使用圆括号而又不想导致这个例外，那么你可以在整个表达式外边放上一对圆括号。 如果你需要在想抽取的子表达式前有圆括号，参阅后文描述的非捕获性圆括号。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="ba29e2a" class="language- ">
  <code>substring(&#39;foobar&#39; from &#39;o.b&#39;)     oob
substring(&#39;foobar&#39; from &#39;o(.)b&#39;)   o</code>
  </pre>
  </div>
<p><strong>regexp_replace</strong>函数提供了将匹配 POSIX 正则表达式模式的子串替换为新文本的功能。 它的语法是 <strong>regexp_replace(source, pattern, replacement [, flags ])</strong>。 如果没有匹配pattern，那么返回不加修改的source串。 如果有匹配，则返回的source串里面的匹配子串将被replacement串替换掉。replacement串可以包含\n， 其中\n是 1 到 9， 表明源串里匹配模式里第n个圆括号子表达式的子串应该被插入， 并且它可以包含&amp;表示应该插入匹配整个模式的子串。如果你需要放一个文字形式的反斜线在替换文本里，那么写\。flags参数是一个可选的文本串，它包含另个或更多单字母标志，这些标志可以改变函数的行为。标志i指定大小写无关的匹配，而标志g指定替换每一个匹配的子串而不仅仅是第一个。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="b56dd87" class="language- ">
  <code>regexp_replace(&#39;foobarbaz&#39;, &#39;b..&#39;, &#39;X&#39;)
                                   fooXbaz
regexp_replace(&#39;foobarbaz&#39;, &#39;b..&#39;, &#39;X&#39;, &#39;g&#39;)
                                   fooXX
regexp_replace(&#39;foobarbaz&#39;, &#39;b(..)&#39;, &#39;X\1Y&#39;, &#39;g&#39;)
                                   fooXarYXazY</code>
  </pre>
  </div>
<p>regexp_match返回一个文本数组，它包含一个POSIX正则表达式模式与一个字符串第一个匹配所得到的子串。其语法是<strong>regexp_match(string, pattern [, flags ])</strong>。如果没有匹配，则结果为NULL。如果找到一个匹配并且pattern不包含带括号的子表达式，那么结果是一个单一元素的文本数组，其中包含匹配整个模式的子串。如果找到一个匹配并且pattern含有带括号的子表达式，那么结果是一个文本数组，其中第n个元素是与pattern的第n个圆括号子表达式匹配的子串（“非捕获”圆括号不计入在内，详见下文）。flags参数是一个可选的文本字符串，它包含零个或者更多个可以改变该函数行为的单字母标志。所支持的标志在表 中介绍。</p>
<p><strong>一些例子</strong>：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="9309c6c" class="language- ">
  <code>SELECT regexp_match(&#39;foobarbequebaz&#39;, &#39;bar.*que&#39;);
 regexp_match
--------------
 {barbeque}
(1 row)
 
SELECT regexp_match(&#39;foobarbequebaz&#39;, &#39;(bar)(beque)&#39;);
 regexp_match
--------------
 {bar,beque}
(1 row)</code>
  </pre>
  </div>
<p>在通常情况下，人们只是想要的大整个匹配的子串或者NULL（没有匹配），可以写成这样</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4fc700e" class="language- ">
  <code>SELECT (regexp_match(&#39;foobarbequebaz&#39;, &#39;bar.*que&#39;))[1];
 regexp_match
--------------
 barbeque
(1 row)</code>
  </pre>
  </div>
<p>regexp_matches函数返回一个文本数组的集合，其中包含着一个POSIX正则表达式模式与一个字符串匹配得到的子串。它和regexp_match具有相同的语法。如果没有匹配，这个函数不会返回行。如果有一个匹配并且给定了g标志，则返回一行。如果有N个匹配并且给定了g标志，则返回N行。每一个返回的行都是一个文本数组，其中含有整个匹配的子串或者匹配pattern的圆括号子表达式的子串，这和上面对regexp_match的介绍一样。regexp_matches接受展示的所有标志，外加令它返回所有匹配而不仅仅是第一个匹配的g标志。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="bcd0221" class="language- ">
  <code>SELECT regexp_matches(&#39;foo&#39;, &#39;not there&#39;);
 regexp_matches
----------------
(0 rows)
 
SELECT regexp_matches(&#39;foobarbequebazilbarfbonk&#39;, &#39;(b[^b]&#43;)(b[^b]&#43;)&#39;, &#39;g&#39;);
 regexp_matches
----------------
 {bar,beque}
 {bazil,barf}
(2 rows)</code>
  </pre>
  </div>
<p>提示：在大部分情况下，regexp_matches()应该与g标志一起使用，因为如果只是想要第一个匹配，使用regexp_match()会更加简单高效。</p>
<p>regexp_split_to_table把一个 POSIX 正则表达式模式当作一个定界符来分离一个串。它的语法形式是regexp_split_to_table(string, pattern [, flags ])。如果没有与pattern的匹配，该函数返回string。如果有至少有一个匹配，对每一个匹配它都返回从上一个匹配的末尾（或者串的开头）到这次匹配开头之间的文本。当没有更多匹配时，它返回从上一次匹配的末尾到串末尾之间的文本。flags参数是一个可选的文本串，它包含零个或更多单字母标志，这些标识可以改变该函数的行为。regexp_split_to_table能支持的标志在表 9.22中描述。</p>
<p>regexp_split_to_array函数的行为和regexp_split_to_table相同，不过regexp_split_to_array会把它的结果以一个text数组的形式返回。它的语法是regexp_split_to_array(string, pattern [, flags ])。这些参数和regexp_split_to_table的相同。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="b956e6a" class="language- ">
  <code>SELECT foo FROM regexp_split_to_table(&#39;the quick brown fox jumps over the lazy dog&#39;, &#39;\s&#43;&#39;) AS foo;
  foo   
-------
 the    
 quick  
 brown  
 fox    
 jumps 
 over   
 the    
 lazy   
 dog    
(9 rows)
 
SELECT regexp_split_to_array(&#39;the quick brown fox jumps over the lazy dog&#39;, &#39;\s&#43;&#39;);
              regexp_split_to_array             
-----------------------------------------------
 {the,quick,brown,fox,jumps,over,the,lazy,dog}
(1 row)
 
SELECT foo FROM regexp_split_to_table(&#39;the quick brown fox&#39;, &#39;\s*&#39;) AS foo;
 foo 
-----
 t         
 h         
 e         
 q         
 u         
 i         
 c         
 k         
 b         
 r         
 o         
 w         
 n         
 f         
 o         
 x         
(16 rows)</code>
  </pre>
  </div>
<p>正如上一个例子所示，正则表达式分离函数会忽略零长度的匹配，这种匹配发生在串的开头或结尾或者正好发生在前一个匹配之后。这和正则表达式匹配的严格定义是相悖的，后者由regexp_match和regexp_matches实现，但是通常前者是实际中最常用的行为。其他软件系统如Perl也使用相似的定义。</p>
<h4 id="正则表达式细节"><strong>正则表达式细节</strong> <a href="#%e6%ad%a3%e5%88%99%e8%a1%a8%e8%be%be%e5%bc%8f%e7%bb%86%e8%8a%82" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h4><p>正则表达式（RE），在POSIX 1003.2 中定义， 它有两种形式：扩展的RE或者是ERE（大概地说就是那些在egrep里的）， 基本的RE或者是BRE（大概地说就是那些在ed里的）。MemFireDB支持两种形式，并且还实现了一些POSIX标准中没有但是在类似 Perl 或者 Tcl 这样的语言中得到广泛应用的一些扩展。使用了那些非POSIX扩展的RE叫高级RE， 或者本文档里说的ARE。ARE 几乎完全是 ERE 的超集，但是 BRE 有几个符号上的不兼容（以及更多的限制）。我们首先描述 ARE 和 ERE 形式， 描述那些只适用于 ARE 的特性，然后描述 BRE 的区别是什么。</p>
<p><strong>注意</strong>:</p>
<p>一个正则表达式被定义为一个或更多分支，它们之间被|分隔。只要能匹配其中一个分支的东西都能匹配正则表达式。</p>
<p>一个分支是一个或多个量化原子或者约束连接而成。一个原子匹配第一个，然后后面的原子匹配第二个， 以此类推；一个空分支匹配空串。</p>
<p>一个量化原子是一个原子， 后面可能跟着一个量词。没有量词的时候，它匹配一个原子， 有量词的时候，它可以匹配若干个原子。</p>
<p>一个约束匹配一个空串，但只是在满足特定条件下才匹配。 约束可以在能够使用原子的地方使用，只是它不能跟着量词。简单的约束在表里显示； 更多的约束稍后描述。</p>
<p><strong>表.正则表达式原子</strong>







<table class="table table-striped">
<thead>
<tr>
<th>原子</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>(re)</td>
<td>（其中re是任何正则表达式） 匹配一个对re的匹配，匹配将为可能的报告被记下</td>
</tr>
<tr>
<td>(?:re)</td>
<td>同上，但是匹配不会为了报告而被记下 （一个“非捕获”圆括号集） （只对 ARE）</td>
</tr>
<tr>
<td>.</td>
<td>匹配任意单个字符</td>
</tr>
<tr>
<td>[chars]</td>
<td>一个方括号表达式， 匹配chars中的任意一个（详见第 9.7.3.2 节）</td>
</tr>
<tr>
<td>\k</td>
<td>（其中k是一个非字母数字字符） 匹配一个被当作普通字符看待的特定字符， 例如，\匹配一个反斜线字符</td>
</tr>
<tr>
<td>\c</td>
<td>其中c是一个字母数字 （可能跟着其它字符），它是一个逃逸， 参阅第 9.7.3.3 节（仅对 ARE； 在 ERE 和 BRE 中，它匹配c）</td>
</tr>
<tr>
<td>{</td>
<td>如果后面跟着一个字符，而不是数字， 那么就匹配左花括弧{；如果跟着一个数字， 那么它是range的开始（见下文）</td>
</tr>
<tr>
<td>x</td>
<td>其中x是一个没有其它意义的单个字符，则匹配该字符</td>
</tr>
</tbody>
</table>
</p>
<p>RE 不能以反斜线（\）结尾。</p>
<p>注意:如果你关掉了standard_conforming_strings，任何你写在文字串常量中的反斜线都需要被双写。</p>
<p>表 . 正则表达式量词







<table class="table table-striped">
<thead>
<tr>
<th>量词</th>
<th>匹配</th>
</tr>
</thead>
<tbody>
<tr>
<td>*</td>
<td>一个由原子的 0 次或更多次匹配组成的序列</td>
</tr>
<tr>
<td>+</td>
<td>一个由原子的 1 次或更多次匹配组成的序列</td>
</tr>
<tr>
<td>?</td>
<td>一个由原子的 0 次或 1 次匹配组成的序列</td>
</tr>
<tr>
<td>{m}</td>
<td>一个由原子的正好m次匹配组成的序列</td>
</tr>
<tr>
<td>{m,}</td>
<td>一个由原子的m次或更多次匹配组成的序列</td>
</tr>
<tr>
<td>{m,n}</td>
<td>一个由原子的从m次到n次（包括）匹配组成的序列；m不能超过n</td>
</tr>
<tr>
<td>*?</td>
<td>*的非贪婪版本</td>
</tr>
<tr>
<td>+?</td>
<td>+的非贪婪版本</td>
</tr>
<tr>
<td>??</td>
<td>?的非贪婪版本</td>
</tr>
<tr>
<td>{m}?</td>
<td>{m}的非贪婪版本</td>
</tr>
<tr>
<td>{m,}?</td>
<td>{m,}的非贪婪版本</td>
</tr>
<tr>
<td>{m,n}?</td>
<td>{m,n}的非贪婪版本</td>
</tr>
</tbody>
</table>
</p>
<p>使用{&hellip;}的形式被称作范围。 一个范围内的数字m和n都是无符号十进制整数， 允许的数值从 0 到 255（包含）。</p>
<p>非贪婪的量词（只在 ARE 中可用）匹配对应的正常 （贪婪）模式，区别是它寻找最少的匹配，而不是最多的匹配。</p>
<p>注意:一个量词不能紧跟在另外一个量词后面，例如**是非法的。量词不能作为表达式或者子表达式的开头，也不能跟在^或者|后面。</p>
<p>表 正则表达式约束







<table class="table table-striped">
<thead>
<tr>
<th>约束</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>^</td>
<td>串开头的匹配</td>
</tr>
<tr>
<td>$</td>
<td>串末尾的匹配</td>
</tr>
<tr>
<td>(?=re)</td>
<td>在匹配re的子串开始的任何点的positive lookahead匹配（只对 ARE）</td>
</tr>
<tr>
<td>(?!re)</td>
<td>在匹配re的子串开始的任何点的negative lookahead匹配（只对 ARE）</td>
</tr>
<tr>
<td>(?&lt;=re)</td>
<td>只要有一个点上有一个子串匹配re端， positive lookbehind就在这个点上匹配（只对 ARE）</td>
</tr>
<tr>
<td>(?&lt;!re)</td>
<td>只要有一个点上没有子串匹配re端， negative  lookbehind就在这个点上匹配（只对 ARE）</td>
</tr>
</tbody>
</table>
</p>
<h4 id="方括号表达式"><strong>方括号表达式</strong> <a href="#%e6%96%b9%e6%8b%ac%e5%8f%b7%e8%a1%a8%e8%be%be%e5%bc%8f" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h4><p>方括号表达式是一个包围在[]中的字符列表。它通常匹配列表中的任意单个字符（但见下文）。 如果列表以^开头，它匹配任意单个不在该列表参与部分中的字符。如果该列表中两个字符用-隔开， 那它就是那两个字符（包括在内）之间的所有字符范围的缩写，例如，在ASCII中[0-9]匹配任何十进制数字。两个范围共享一个端点是非法的，例如，a-c-e。范围与字符集关系密切， 可移植的程序应该避免依靠它们。</p>
<p>想在列表中包含文本]，可以让它做列表的首字符（如果使用了^，需要放在其后）。 想在列表中包含文本-，可以让它做列表的首字符或者尾字符，或者一个范围的第二个端点。 想在列表中把文本-当做范围的起点， 把它用[.和.]包围起来，这样它就成为一个排序元素（见下文）。 除了这些字符本身、一些用[的组合（见下段）以及逃逸（只在 ARE 中有效）以外，所有其它特殊字符 在方括号表达式里都失去它们的特殊含义。特别是，在 ERE 和 BRE 规则下\不是特殊的， 但在 ARE 里，它是特殊的（引入一个逃逸）。</p>
<p>在一个方括号表达式里，一个排序元素（一个字符、一个被当做一个单一字符排序的多字符序列或者一个表示上面两种情况的排序序列名称） 包含在[.和.]里面的时候表示该排序元素的字符序列。该序列被当做该方括号列表 的一个单一元素。这允许一个包含多字符排序元素的方括号表达式去匹配多于一个字符，例如，如果排序序列包含一个ch排序元素， 那么 RE [[.ch.]]*c匹配chchcc的头五个字符。</p>
<p>在方括号表达式里，包围在[=和=]里的排序元素是一个等价类， 代表等效于那一个的所有排序元素的字符序列，包括它本身（如果没有其它等效排序元素，那么就好象封装定界符是[.和 .]）。例如，如果o和^是一个等价类的成员，那么[[=o=]]、[[=^=]]和[o^]都是同义的。一个等价类不能是一个范围的端点。</p>
<p>在方括号表达式里，在[:和:]里面封装的字符类的名字代表属于该类的所有字符的列表。 标准的字符类名字是：alnum、 alpha、blank、 cntrl、digit、 graph、lower、 print、punct、 space、upper、 xdigit。 它们代表在ctype中定义的字符类。 一个区域可以会提供其他的类。字符类不能用做一个范围的端点。</p>
<p>方括号表达式里有两个特例：方括号表达式[[:&lt;:]]和[[:&gt;:]]是约束，分别匹配一个单词开头和结束的空串。 单词定义为一个单词字符序列，前面和后面都没有其它单词字符。单词字符是一个alnum字符（和ctype中定义的一样） 或者一个下划线。这是一个扩展，兼容POSIX 1003.2， 但那里面并没有说明， 而且在准备移植到其他系统里去的软件里一定要小心使用。通常下文描述的约束逃逸更好些（它们并非更标准，但是更容易键入）。</p>
<h4 id="正则表达式逃逸"><strong>正则表达式逃逸</strong> <a href="#%e6%ad%a3%e5%88%99%e8%a1%a8%e8%be%be%e5%bc%8f%e9%80%83%e9%80%b8" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h4><p>逃逸是以\开头，后面跟着一个字母数字字符得特殊序列。 逃逸有好几种变体：字符项、类缩写、约束逃逸以及后引用。在 ARE 里， 如果一个\后面跟着一个字母数字，但是并未组成一个合法的逃逸， 那么它是非法的。在 ERE 中没有逃逸：在方括号表达式之外，一个后面跟着字母数字字符的\只是表示该字符是一个普通的字符，而且在一个方括号表达式里，\是一个普通的字符（后者实际上在 ERE 和 ARE 不兼容）。</p>
<p>字符项逃逸用于便于我们在 RE 中声明那些不可打印的或其他习惯的字符。</p>
<p>类缩写逃逸用来提供一些常用的字符类缩写。。</p>
<p>约束逃逸是一个约束，如果满足特定的条件，它匹配该空串。</p>
<p>后引用（\n）匹配数字\n指定的被前面的圆括号子表达式匹配的同一个串。例如， ([bc])\1匹配bb或者cc， 但是不匹配bc或者cb。RE 中子表达式必须完全在后引用前面。子表达式以它们的先导圆括号的顺序编号。非捕获圆括号并不定义子表达式。</p>
<p><strong>表  正则表达式字符项逃逸</strong>







<table class="table table-striped">
<thead>
<tr>
<th>逃逸</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>\a</td>
<td>警告（响铃）字符，和 C 中一样</td>
</tr>
<tr>
<td>\b</td>
<td>退格，和 C 中一样</td>
</tr>
<tr>
<td>\B</td>
<td>反斜线（\）的同义词，用来减少双写反斜线</td>
</tr>
<tr>
<td>\cX</td>
<td>（其中X是任意字符）低序5位和X相同的字符，它的其他位都是零</td>
</tr>
<tr>
<td>\e</td>
<td>排序序列名为ESC的字符，如果无法做到该字符为八进制值 033</td>
</tr>
<tr>
<td>\f</td>
<td>换页，和 C 中一样</td>
</tr>
<tr>
<td>\n</td>
<td>新行，和 C 中一样</td>
</tr>
<tr>
<td>\r</td>
<td>回车，和 C 中一样</td>
</tr>
<tr>
<td>\t</td>
<td>水平制表符，和 C 中一样</td>
</tr>
<tr>
<td>\uwxyz</td>
<td>（其中wxyz正好是四个十六进制位）十六进制值为0xwxyz的字符</td>
</tr>
<tr>
<td>\Ustuvwxyz</td>
<td>（其中stuvwxyz正好是八个十六进制位）十六进制值为0xstuvwxyz的字符</td>
</tr>
<tr>
<td>\v</td>
<td>垂直制表符，和 C 中一样</td>
</tr>
<tr>
<td>\xhhh</td>
<td>（其中hhh是十六进制位的任意序列）十六进制值为0xhhh的字符（一个单一字符，不管用了多少个十六进制位）</td>
</tr>
<tr>
<td>\0</td>
<td>值为0（空字节）的字符</td>
</tr>
<tr>
<td>\xy</td>
<td>（其中xy正好是两个八进制位，并且不是一个后引用）八进制值为0xy的字符</td>
</tr>
<tr>
<td>\xyz</td>
<td>（其中xyz正好是三个八进制位，并且不是一个后引用）八进制值为0xyz的字符</td>
</tr>
</tbody>
</table>
</p>
<p>十六进制位是0-9、a-f和A-F。八进制位是0-7。</p>
<p>指定 ASCII 范围（0-127）之外的值的数字字符项转义的含义取决于数据库编码。 当编码是 UTF-8 时，转义值等价于 Unicode 代码点，例如 \u1234表示字符U+1234。对于其他多字节编码， 字符项转义通常只是指定该字符的字节值的串接。如果该转义值不对应数据库编码 中的任何合法字符，将不会发生错误，但是它不会匹配任何数据。</p>
<p>字符项逃逸总是被当作普通字符。例如，\135是 ASCII 中的]， 但\135并不终止一个方括号表达式。</p>
<p><strong>表  正则表达式类缩写逃逸</strong>







<table class="table table-striped">
<thead>
<tr>
<th>逃逸</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>\d</td>
<td><code>[[:digit:]] </code></td>
</tr>
<tr>
<td>\s</td>
<td><code>[[:space:]] </code></td>
</tr>
<tr>
<td>\w</td>
<td><code>[[:alnum:]_]</code>（注意下划线是被包括的）</td>
</tr>
<tr>
<td>\D</td>
<td><code>[^[:digit:]] </code></td>
</tr>
<tr>
<td>\S</td>
<td><code>[^[:space:]]</code></td>
</tr>
<tr>
<td>\W</td>
<td><code>[^[:alnum:]_] </code>（注意下划线是被包括的）</td>
</tr>
</tbody>
</table>
</p>
<p>在方括号表达式里，\d、\s和\w会失去它们的外层方括号，而\D、\S和 \W是非法的（也就是说，例如[a-c\d]等效于[a-c[:digit:]]。同样[a-c\D]等效于 <code>[a-c^[:digit:]]</code>的，也是非法的）。</p>
<p><strong>表.正则表达式约束逃逸</strong>







<table class="table table-striped">
<thead>
<tr>
<th>逃逸</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>\A</td>
<td>只在串开头匹配</td>
</tr>
<tr>
<td>\m</td>
<td>只在一个词的开头匹配</td>
</tr>
<tr>
<td>\M</td>
<td>只在一个词的末尾匹配</td>
</tr>
<tr>
<td>\y</td>
<td>只在一个词的开头或末尾匹配</td>
</tr>
<tr>
<td>\Y</td>
<td>只在一个词的不是开头或末尾的点上匹配</td>
</tr>
<tr>
<td>\Z</td>
<td>只在串的末尾匹配</td>
</tr>
</tbody>
</table>
</p>
<p>一个词被定义成在上面[[:&lt;:]]和[[:&gt;:]]中的声明。在方括号表达式里，约束逃逸是非法的。</p>
<p><strong>表  正则表达式后引用</strong>







<table class="table table-striped">
<thead>
<tr>
<th>逃逸</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>\m</td>
<td>（其中m是一个非零位）一个到第m个子表达式的后引用</td>
</tr>
<tr>
<td>\mnn</td>
<td>（其中m是一个非零位，并且nn是一些更多的位，并且十六进制值mnn不超过目前能看到的封闭捕获圆括号的数目）一个到第mnn个子表达式的后引用</td>
</tr>
</tbody>
</table>
</p>
<p>注意</p>
<p>在八进制字符项逃逸和后引用之间有一个历史继承的歧义存在，这个歧义是 通过下面的启发式规则解决的，像上面描述地那样。前导零总是表示这是一个八进制逃逸。 而单个非零数字，如果没有跟着任何其它位，那么总是被认为后引用。 一个多位的非零开头的序列也被认为是后引用，只要它出现在合适的子表达式后面 （也就是说，在后引用的合法范围中的数），否则就被认为是一个八进制。</p>
<h4 id="正则表达式元语法"><strong>正则表达式元语法</strong> <a href="#%e6%ad%a3%e5%88%99%e8%a1%a8%e8%be%be%e5%bc%8f%e5%85%83%e8%af%ad%e6%b3%95" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h4><p>除了上面描述的主要语法之外，还有几种特殊形式和杂项语法。</p>
<p>如果一个 RE 以***:开头，那么剩下的 RE 都被当作 ARE。如果一个 RE 以***=开头， 那么剩下的 RE 被当作一个文本串，所有的字符都被认为是一个普通字符。</p>
<p>一个 ARE 可以以嵌入选项开头：一个序列(?xyz)（这里的xyz是一个或多个字母字符）声明影响剩余 RE 的选项。 这些选项覆盖任何前面判断的选项 — 特别地，它们可以覆盖一个正则表达式操作符隐含的大小写敏感的行为，或者覆盖flags参数中的正则表达式函数。可用的选项字母在表中显示。注意这些同样的选项字母也被用在正则表达式函数的flags参数中。</p>
<p><strong>表  ARE嵌入选项字母</strong>







<table class="table table-striped">
<thead>
<tr>
<th>选项</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>b</td>
<td>RE的剩余部分是一个BRE</td>
</tr>
<tr>
<td>c</td>
<td>大小写敏感的匹配（覆盖操作符类型）</td>
</tr>
<tr>
<td>e</td>
<td>RE的剩余部分是一个ERE</td>
</tr>
<tr>
<td>i</td>
<td>大小写不敏感的匹配（覆盖操作符类型）</td>
</tr>
<tr>
<td>m</td>
<td>n的历史原因的同义词</td>
</tr>
<tr>
<td>n</td>
<td>新行敏感的匹配</td>
</tr>
<tr>
<td>p</td>
<td>部分新行敏感的匹配</td>
</tr>
<tr>
<td>q</td>
<td>RE的剩余部分是一个文字（“quoted”）串，全部是普通字符</td>
</tr>
<tr>
<td>s</td>
<td>非新行敏感的匹配（默认）</td>
</tr>
<tr>
<td>t</td>
<td>紧语法（默认，见下文）</td>
</tr>
<tr>
<td>w</td>
<td>逆部分新行敏感（“怪异”）的匹配</td>
</tr>
<tr>
<td>x</td>
<td>扩展语法（见下文）</td>
</tr>
</tbody>
</table>
</p>
<p>嵌入选项在)终止序列时发生作用。它们只在 ARE 的开始处起作用 （在任何可能存在的***:控制器后面）。</p>
<p>除了通常的（紧）RE 语法（这种情况下所有字符都有效）， 还有一种扩展语法，可以通过声明嵌入的x选项获得。在扩展语法里，RE 中的空白字符被忽略，就像那些在#和其后的新行（或 RE 的末尾）之间的字符一样。这样就允许我们给一个复杂的 RE 分段和注释。不过这个基本规则有三种例外：</p>
<p>·   空白字符或前置了\的#将被保留</p>
<p>·   方括号表达式里的空白或者#将被保留</p>
<p>·   在多字符符号里面不能出现空白和注释，例如(?:</p>
<p>为了这个目的，空白是空格、制表符、新行和任何属于空白字符类的字符。</p>
<p>最后，在 ARE 里，方括号表达式外面，序列(?#ttt)（其中ttt是任意不包含一个))的文本）是一个注释， 它被完全忽略。同样，这样的东西是不允许出现在多字符符号的字符中间的，例如 (?:。这种注释更像是一种历史产物而不是一种有用的设施，并且它们的使用已经被废弃；请使用扩展语法来替代。</p>
<p>如果声明了一个初始的***=控制器，那么所有这些元语法扩展都不能使用，因为这样表示把用户输入当作一个文字串而不是 RE 对待。</p>
<h4 id="正则表达式匹配规则"><strong>正则表达式匹配规则</strong> <a href="#%e6%ad%a3%e5%88%99%e8%a1%a8%e8%be%be%e5%bc%8f%e5%8c%b9%e9%85%8d%e8%a7%84%e5%88%99" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h4><p>在 RE 可以在给定串中匹配多于一个子串的情况下， RE 匹配串中最靠前的那个子串。如果 RE 可以匹配在那个位置开始 的多个子串，要么是取最长的子串，要么是最短的，具体哪种， 取决于 RE 是贪婪的还是非贪婪的。</p>
<p>一个 RE 是否贪婪取决于下面规则：</p>
<p>·   大多数原子以及所有约束，都没有贪婪属性（因为它们毕竟无法匹配个数变化的文本）。</p>
<p>·   在一个 RE 周围加上圆括号并不会改变其贪婪性。</p>
<p>·   带一个固定重复次数量词 （{m}或者{m}?） 的量化原子和原子自身具有同样的贪婪性（可能是没有）。</p>
<p>·   一个带其他普通的量词（包括{m,n}中m等于n的情况）的量化原子是贪婪的（首选最长匹配）。</p>
<p>·   一个带非贪婪量词（包括{m,n}?中m等于 n的情况）的量化原子是非贪婪的（首选最短匹配）。</p>
<p>·   一个分支 — 也就是说，一个没有顶级|操作符的 RE — 和它里面的第一个有贪婪属性的量化原子有着同样的贪婪性。</p>
<p>·   一个由|操作符连接起来的两个或者更多分支组成的 RE 总是贪婪的。</p>
<p>上面的规则所描述的贪婪属性不仅仅适用于独立的量化原子， 而且也适用于包含量化原子的分支和整个 RE。这里的意思是， 匹配是按照分支或者整个 RE 作为一个整体匹配最长或者最短的可能子串。 一旦整个匹配的长度确定，那么匹配任意特定子表达式的部分就基于该子表达式的贪婪属性进行判断，在 RE 里面靠前的子表达式的优先级高于靠后的子表达式。</p>
<p>一个相应的例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="ed2c66b" class="language- ">
  <code>SELECT SUBSTRING(&#39;XY1234Z&#39;, &#39;Y*([0-9]{1,3})&#39;);
结果：123
SELECT SUBSTRING(&#39;XY1234Z&#39;, &#39;Y*?([0-9]{1,3})&#39;);
结果：1</code>
  </pre>
  </div>
<p>在第一个例子里，RE 作为整体是贪婪的，因为Y<em>是贪婪的。它可以匹配从Y开始的东西，并且它匹配从这个位置开始的最长的串， 也就是，Y123。输出是这里的圆括号包围的部分，或者说是123。在第二个例子里， RE 总体上是一个非贪婪的 RE，因为Y</em>?是非贪婪的。它可以匹配从Y开始的最短的子串，也就是说Y1。子表达式[0-9]{1,3}是贪婪的，但是它不能修改总体匹配长度的决定； 因此它被迫只匹配1。</p>
<p>简而言之，如果一个 RE 同时包含贪婪和非贪婪的子表达式，那么总的匹配长度要么是尽可能长，要么是尽可能短，这取决于给整个 RE 赋予的属性。给子表达式赋予的属性只影响在这个匹配里，各个子表达式之间相互允许“吃掉”的多少。</p>
<p>量词{1,1}和{1,1}?可以分别用于在一个子表达式 或者整个 RE 上强制贪婪或者非贪婪。当需要整个 RE 具有不同于从其元素中 推导出的贪婪属性时，这很有用。例如，假设我们尝试将一个包含一些数字的 字符串分隔成数字以及在它们之前和之后的部分，我们可能会尝试这样做：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2c796aa" class="language- ">
  <code>SELECT regexp_matches(&#39;abc01234xyz&#39;, &#39;(.*)(\d&#43;)(.*)&#39;);
Result: {abc0123,4,xyz}</code>
  </pre>
  </div>
<p>这不会有用：第一个.*是贪婪的，因此它会“吃掉” 尽可能多的字符而留下\d+去匹配在最后一个可能位置上的最 后一个数字。我们可能会通过让它变成非贪婪来修复：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="65a5387" class="language- ">
  <code>SELECT regexp_matches(&#39;abc01234xyz&#39;, &#39;(.*?)(\d&#43;)(.*)&#39;);
Result: {abc,0,&#34;&#34;}</code>
  </pre>
  </div>
<p>这也不会有用：因为现在 RE 作为整体来说是非贪婪的，因此它会尽快结束 全部的匹配。我们可以通过强制 RE 整体是贪婪的来得到我们想要的：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="78d043b" class="language- ">
  <code>SELECT regexp_matches(&#39;abc01234xyz&#39;, &#39;(?:(.*?)(\d&#43;)(.*)){1,1}&#39;);
Result: {abc,01234,xyz}</code>
  </pre>
  </div>
<p>独立于 RE 的组件的贪婪性之外控制 RE 的整体贪婪性为处理变长模式提供了 很大的灵活性。</p>
<p>在决定更长或者更短的匹配时，匹配长度是以字符衡量的，而不是排序元素。一个空串会被认为比什么都不匹配长。例如：bb<em>匹配abbbc的中间三个字符；(week|wee)(night|knights)匹配weeknights的所有十个字符； 而(.</em>).<em>匹配 abc的时候，圆括号包围的子表达式匹配所有三个字符；当(a</em>)*被拿来匹配bc时，整个 RE 和圆括号 子表达式都匹配一个空串。</p>
<p>如果声明了大小写无关的匹配，那么效果就好像所有大小写区别在字母表中消失了。如果在多个情况中一个字母以一个普通字符的形式出现在方括号表达式外面，那么它实际上被转换成 一个包含大小写的方括号表达式，也就是说，x 变成 [xX]。 如果它出现在一个方括号表达式里面，那么它的所有大小写的同族都被加入 方括号表达式中，也就是说，x变成[xX]。当它出现在一个方括号表达式内时，它的所有大小写副本都被加入到方括号表达式中，例如， [x]会变成[xX]，而[^x]会变成[^xX]。</p>
<p>如果指定了新行敏感的匹配，.和使用^的方括号表达式 将永远不会匹配新行字符（这样，匹配就绝对不会跨越新行，除非 RE 显式地安排了这样的情况）并且^和$除了分别匹配串开头和结尾之外，还将分别匹配新行后面和前面的空串。但是 ARE 逃逸\A和\Z仍然只匹配串的开头和结尾。</p>
<p>如果指定了部分新行敏感的匹配，那么它影响.和方括号表达式， 这个时候和新行敏感的匹配一样，但是不影响^和$。</p>
<p>如果指定了逆新行敏感匹配，那么它影响^和$，其作用和在新行敏感的匹配里一样，但是不影响.和方括号表达式。这个并不是很有用，只是为了满足对称性而提供的。</p>
<h4 id="限制和兼容性"><strong>限制和兼容性</strong> <a href="#%e9%99%90%e5%88%b6%e5%92%8c%e5%85%bc%e5%ae%b9%e6%80%a7" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h4><p>在这个实现里，对 RE 的长度没有特别的限制。但是，那些希望高移植性的程序应该避免使用长度超过 256 字节的 RE，因为 POSIX 兼容 的实现可以拒绝接受这样的 RE。</p>
<p>ARE 实际上和 POSIX ERE 不兼容的唯一的特性是在方括号表达式里\并不失去它特殊的含义。所有其它 ARE 特性都使用在 POSIX ERE 里面是非法或者是未定义、未声明效果的语法；指示器的***就是在 POSIX 的 BRE 和 ERE 之外的语法。</p>
<p>许多 ARE 扩展都是从 Perl 那里借来的（但是有些被做了修改来清理它们），以及一些 Perl 里没有出现的扩展。要注意的不兼容性包括\b、\B、对结尾的新行缺乏特别的处理、对那些被新行敏感匹配的东西附加的补齐方括号表达式、在 lookahead/lookbehind 约束里对圆括号和后引用的限制以及最长/最短 匹配（而不是第一匹配）的语义。</p>
<p>在 ARE 中，后面跟着一个字母数字字符的\要么是一个逃逸要么是一个错误， 但是在以前的版本里，它只是写该字母数字字符的另外一种方法。这个应该不是什么问题， 因为在以前的版本里没有什么理由会让我们写这样的序列。</p>
<p>在 ARE 里，\在[]里还是一个特殊字符， 因此在方括号表达式里的一个文本\必须被写成\。</p>
<h4 id="基本正则表达式"><strong>基本正则表达式</strong> <a href="#%e5%9f%ba%e6%9c%ac%e6%ad%a3%e5%88%99%e8%a1%a8%e8%be%be%e5%bc%8f" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h4><p>BRE 在几个方面和 ERE 不太一样。在 BRE 中，|、+和?都是普通字符并且没有与它们功能等价的东西。范围的定界符是{和}， 因为 {和}本身是普通字符。嵌套的子表达式的圆括号是(和)，因为(和)自身是普通字符。除非在 RE 开头或者是圆括号子表达式开头，^都是一个普通字符。 除非在 RE 结尾或者是圆括号子表达式的结尾，$是一个普通字符。如果*出现在 RE 开头或者是圆括号封装的子表达式开头 （前面可能有^），那么它是个普通字符。最后，可以用单数字的后引用，&lt;和&gt;分别是[[:&lt;:]]和[[:&gt;:]]的同义词；在 BRE 中没有其它可用的逃逸。</p>
<h2 id="数据类型格式化函数">数据类型格式化函数 <a href="#%e6%95%b0%e6%8d%ae%e7%b1%bb%e5%9e%8b%e6%a0%bc%e5%bc%8f%e5%8c%96%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>格式化函数提供一套强大的工具用于把各种数据类型 （日期/时间、整数、浮点、数字） 转换成格式化的字符串以及反过来从格式化的字符串转换成 指定的数据类型。。这些函数都遵循一个公共的调用规范： 第一个参数是待格式化的值，而第二个是一个定义输出或输入格式的模板。</p>
<p><strong>表 格式化函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
</tr>
</thead>
<tbody>
<tr>
<td>to_char(timestamp, text)</td>
<td>text</td>
<td>把时间戳转成字符串</td>
<td>to_char(current_timestamp, <code>'HH12:MI:SS'</code>)</td>
</tr>
<tr>
<td>to_char(interval, text)</td>
<td>text</td>
<td>把间隔转成字符串</td>
<td>to_char(interval &lsquo;15h 2m 12s&rsquo;,  <code>'HH24:MI:SS'</code>)</td>
</tr>
<tr>
<td>to_char(int, text)</td>
<td>text</td>
<td>把整数转成字符串</td>
<td>to_char(125, &lsquo;999&rsquo;)</td>
</tr>
<tr>
<td>to_char(double precision, text)</td>
<td>text</td>
<td>把实数或双精度转成字符串</td>
<td>to_char(125.8::real, &lsquo;999D9&rsquo;)</td>
</tr>
<tr>
<td>to_char(numeric, text)</td>
<td>text</td>
<td>把数字转成字符串</td>
<td>to_char(-125.8, &lsquo;999D99S&rsquo;)</td>
</tr>
<tr>
<td>to_date(text, text)</td>
<td>date</td>
<td>把字符串转成日期</td>
<td>to_date(&lsquo;05 Dec 2000&rsquo;,  &lsquo;DD Mon YYYY&rsquo;)</td>
</tr>
<tr>
<td>to_number(text, text)</td>
<td>numeric</td>
<td>把字符串转成数字</td>
<td>to_number(&lsquo;12,454.8-&rsquo;, &lsquo;99G999D9S&rsquo;)</td>
</tr>
<tr>
<td>to_timestamp(text, text)</td>
<td>timestamp with time zone</td>
<td>把字符串转成时间戳</td>
<td>to_timestamp(&lsquo;05 Dec 2000&rsquo;,  &lsquo;DD Mon YYYY&rsquo;)</td>
</tr>
</tbody>
</table>
</p>
<p>注意:还有一个单一参数的to_timestamp函数。</p>
<p>提示:to_timestamp和to_date存在的目的是为了处理无法用简单造型转换的输入格式。对于大部分标准的日期/时间格式，简单地把源字符串造型成所需的数据类型是可以的，并且简单很多。类似地，对于标准的数字表示形式，to_number也是没有必要的。</p>
<p>在一个to_char输出模板串中，一些特定的模式可以被识别并且被替换成基于给定值的被恰当地格式化的数据。任何不属于模板模式的文本都简单地照字面拷贝。同样，在一个输入 模板串里（对其他函数），模板模式标识由输入数据串提供的值。如果在模板字符串中有不是模板模式的字符，输入数据字符串中的对应字符会被简单地跳过（不管它们是否等于模板字符串字符）。</p>
<p>[表 ]展示了可以用于格式化日期和时间值的模版。</p>
<p><strong>表  .用于日期/时间格式化的模板模式</strong>







<table class="table table-striped">
<thead>
<tr>
<th>模式</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>HH</td>
<td>一天中的小时 （01-12）</td>
</tr>
<tr>
<td>HH12</td>
<td>一天中的小时 （01-12）</td>
</tr>
<tr>
<td>HH24</td>
<td>一天中的小时 （00-23）</td>
</tr>
<tr>
<td>MI</td>
<td>分钟 （00-59）minute (00-59)</td>
</tr>
<tr>
<td>SS</td>
<td>秒（00-59）</td>
</tr>
<tr>
<td>MS</td>
<td>毫秒（000-999）</td>
</tr>
<tr>
<td>US</td>
<td>微秒（000000-999999）</td>
</tr>
<tr>
<td>SSSS</td>
<td>午夜后的秒（0-86399）</td>
</tr>
<tr>
<td>AM, am, PM or pm</td>
<td>正午指示器（不带句号）</td>
</tr>
<tr>
<td>A.M., a.m., P.M. or p.m.</td>
<td>正午指示器（带句号）</td>
</tr>
<tr>
<td>Y,YYY</td>
<td>带逗号的年（4 位或者更多位）</td>
</tr>
<tr>
<td>YYYY</td>
<td>年（4 位或者更多位）</td>
</tr>
<tr>
<td>YYY</td>
<td>年的后三位</td>
</tr>
<tr>
<td>YY</td>
<td>年的后两位</td>
</tr>
<tr>
<td>Y</td>
<td>年的最后一位</td>
</tr>
<tr>
<td>IYYY</td>
<td>ISO 8601 周编号方式的年（4 位或更多位）</td>
</tr>
<tr>
<td>IYY</td>
<td>ISO 8601 周编号方式的年的最后 3 位</td>
</tr>
<tr>
<td>IY</td>
<td>ISO 8601 周编号方式的年的最后 2 位</td>
</tr>
<tr>
<td>I</td>
<td>ISO 8601 周编号方式的年的最后一位</td>
</tr>
<tr>
<td>BC, bc, AD或者ad</td>
<td>纪元指示器（不带句号）</td>
</tr>
<tr>
<td>B.C., b.c., A.D.或者a.d.</td>
<td>纪元指示器（带句号）</td>
</tr>
<tr>
<td>MONTH</td>
<td>全大写形式的月名（空格补齐到 9 字符）</td>
</tr>
<tr>
<td>Month</td>
<td>全首字母大写形式的月名（空格补齐到 9 字符）</td>
</tr>
<tr>
<td>month</td>
<td>全小写形式的月名（空格补齐到 9 字符）</td>
</tr>
<tr>
<td>MON</td>
<td>简写的大写形式的月名（英文 3 字符，本地化长度可变）</td>
</tr>
<tr>
<td>Mon</td>
<td>简写的首字母大写形式的月名（英文 3 字符，本地化长度可变）</td>
</tr>
<tr>
<td>mon</td>
<td>简写的小写形式的月名（英文 3 字符，本地化长度可变）</td>
</tr>
<tr>
<td>MM</td>
<td>月编号（01-12）</td>
</tr>
<tr>
<td>DAY</td>
<td>全大写形式的日名（空格补齐到 9 字符）</td>
</tr>
<tr>
<td>Day</td>
<td>全首字母大写形式的日名（空格补齐到 9 字符）</td>
</tr>
<tr>
<td>day</td>
<td>全小写形式的日名（空格补齐到 9 字符）</td>
</tr>
<tr>
<td>DY</td>
<td>简写的大写形式的日名（英语 3 字符，本地化长度可变）</td>
</tr>
<tr>
<td>Dy</td>
<td>简写的首字母大写形式的日名（英语 3 字符，本地化长度可变）</td>
</tr>
<tr>
<td>dy</td>
<td>简写的小写形式的日名（英语 3 字符，本地化长度可变）</td>
</tr>
<tr>
<td>DDD</td>
<td>一年中的日（001-366）</td>
</tr>
<tr>
<td>IDDD</td>
<td>ISO 8601 周编号方式的年中的日（001-371，年的第 1 日时第一个 ISO 周的周一）</td>
</tr>
<tr>
<td>DD</td>
<td>月中的日（01-31）</td>
</tr>
<tr>
<td>D</td>
<td>周中的日，周日（1）到周六（7）</td>
</tr>
<tr>
<td>ID</td>
<td>周中的 ISO 8601 日，周一（1）到周日（7）</td>
</tr>
<tr>
<td>W</td>
<td>月中的周（1-5）（第一周从该月的第一天开始）</td>
</tr>
<tr>
<td>WW</td>
<td>年中的周数（1-53）（第一周从该年的第一天开始）</td>
</tr>
<tr>
<td>IW</td>
<td>ISO 8601 周编号方式的年中的周数（01 - 53；新的一年的第一个周四在第一周）</td>
</tr>
<tr>
<td>CC</td>
<td>世纪（2 位数）（21 世纪开始于 2001-01-01）</td>
</tr>
<tr>
<td>J</td>
<td>儒略日（从午夜 UTC 的公元前 4714 年 11 月 24 日开始的整数日数）</td>
</tr>
<tr>
<td>Q</td>
<td>季度（to_date和to_timestamp会忽略）</td>
</tr>
<tr>
<td>RM</td>
<td>大写形式的罗马计数法的月（I-XII；I 是 一月）</td>
</tr>
<tr>
<td>rm</td>
<td>小写形式的罗马计数法的月（i-xii；i 是 一月）</td>
</tr>
<tr>
<td>TZ</td>
<td>大写形式的时区缩写（仅在to_char中支持）</td>
</tr>
<tr>
<td>tz</td>
<td>小写形式的时区缩写（仅在to_char中支持）</td>
</tr>
<tr>
<td>TZH</td>
<td>时区的小时</td>
</tr>
<tr>
<td>TZM</td>
<td>时区的分钟</td>
</tr>
<tr>
<td>OF</td>
<td>从UTC开始的时区偏移（仅在to_char中支持）</td>
</tr>
</tbody>
</table>
</p>
<p>修饰语可以被应用于模板模式来修改它们的行为。例如，FMMonth就是带着FM修饰语的Month模式。展示了可用于日期/时间格式化的修饰语模式。</p>
<p><strong>表.  用于日期/时间格式化的模板模式修饰语</strong>







<table class="table table-striped">
<thead>
<tr>
<th>修饰语</th>
<th>描述</th>
<th>例子</th>
</tr>
</thead>
<tbody>
<tr>
<td>FM prefix</td>
<td>填充模式（抑制前导零和填充的空格）</td>
<td>FMMonth</td>
</tr>
<tr>
<td>TH suffix</td>
<td>大写形式的序数后缀</td>
<td>DDTH, e.g., 12TH</td>
</tr>
<tr>
<td>th suffix</td>
<td>小写形式的序数后缀</td>
<td>DDth, e.g., 12th</td>
</tr>
<tr>
<td>FX prefix</td>
<td>固定的格式化全局选项（见使用须知）</td>
<td>FX Month DD Day</td>
</tr>
<tr>
<td>TM prefix</td>
<td>翻译模式（基于[lc_time]打印本地化的日和月名）</td>
<td>TMMonth</td>
</tr>
<tr>
<td>SP suffix</td>
<td>拼写模式（未实现）</td>
<td>DDSP</td>
</tr>
</tbody>
</table>
</p>
<p>日期/时间格式化的使用须知：</p>
<p>·   FM抑制前导的零或尾随的空白， 否则会把它们增加到输入从而把一个模式的输出变成固定宽度。FM只修改下一个声明，而在 Oracle 中，FM影响所有随后的声明，并且重复的FM修饰语将触发填充模式开和关。</p>
<p>·   TM不包括结尾空白。to_timestamp和to_date会忽略TM修饰语。</p>
<p>·   如果没有使用FX选项，to_timestamp和to_date会跳过输入字符串中的多个空白。例如，to_timestamp(&lsquo;2000  JUN&rsquo;, &lsquo;YYYY MON&rsquo;)是正确的，但to_timestamp(&lsquo;2000  JUN&rsquo;, &lsquo;FXYYYY MON&rsquo;)会返回一个错误，因为to_timestamp只期望一个空白。FX必须被指定为模板中的第一个项。</p>
<p>·   在to_char模板里可以有普通文本，并且它们会被照字面输出。你可以把一个子串放到双引号里强迫它被解释成一个文本，即使它里面包含模板模式也如此。例如，在 &lsquo;&ldquo;Hello Year &ldquo;YYYY&rsquo;中，YYYY将被年份数据代替，但是Year中单独的Y不会。在to_date、to_number以及to_timestamp中，文本和双引号字符串会导致跳过该字符串中所包含的字符数量，例如&quot;XX&quot;会跳过两个输入字符（不管它们是不是XX）。</p>
<p>·   如果你想在输出里有双引号，那么你必须在它们前面放反斜线，例如 &lsquo;&quot;YYYY Month&quot;&rsquo;。不然，在双引号字符串外面的反斜线就不是特殊的。在双引号字符串内，反斜线会导致下一个字符被取其字面形式，不管它是什么字符（但是这没有特殊效果，除非下一个字符是一个双引号或者另一个反斜线）。</p>
<p>·   在to_timestamp和to_date中，如果年份格式声明少于四位（如YYY）并且提供的年份少于四位，年份将被调整为最接近于 2020 年，例如95会变成 1995。</p>
<p>·   在to_timestamp和to_date中，在处理超过4位数的年份时，YYYY转换具有限制。你必须在YYYY后面使用一些非数字字符或者模板， 否则年份总是被解释为 4 位数字。例如（对于 20000 年）：to_date(&lsquo;200001131&rsquo;, &lsquo;YYYYMMDD&rsquo;)将会被解释成一个 4 位数字的年份，而不是在年份后使用一个非数字分隔符，像to_date(&lsquo;20000-1131&rsquo;, &lsquo;YYYY-MMDD&rsquo;)或to_date(&lsquo;20000Nov31&rsquo;, &lsquo;YYYYMonDD&rsquo;)。</p>
<p>·   在to_timestamp和to_date中，CC（世纪）字段会被接受，但是如果有YYY、YYYY或者Y,YYY字段则会忽略它。如果CC与YY或Y一起使用，则结果被计算为指定世纪中的那一年。如果指定了世纪但是没有指定年，则会假定为该世纪的第一年。</p>
<p>·   在to_timestamp和to_date中，工作日名称或编号（DAY、D以及相关的字段类型）会被接受，但会为了计算结果的目的而忽略。季度（Q）字段也是一样。</p>
<p>·   在to_timestamp和to_date中，一个 ISO 8601 周编号的日期（与一个格里高利日期相区别）可以用两种方法之一被指定为to_timestamp和to_date：</p>
<p>n 年、周编号和工作日：例如to_date(&lsquo;2006-42-4&rsquo;, &lsquo;IYYY-IW-ID&rsquo;)返回日期2006-10-19。如果你忽略工作日，它被假定为 1（周一）。</p>
<p>n 年和一年中的日：例如to_date(&lsquo;2006-291&rsquo;, &lsquo;IYYY-IDDD&rsquo;)也返回2006-10-19。</p>
<p>尝试使用一个混合了 ISO 8601 周编号和格里高利日期的域来输入一个日期是无意义的，并且将导致一个错误。在一个 ISO 周编号的年的环境下，一个“月”或“月中的日”的概念没有意义。在一个格里高利年的环境下，ISO 周没有意义。用户应当避免混合格里高利和 ISO 日期声明。</p>
<p>小心:虽然to_date将会拒绝混合使用格里高利和 ISO 周编号日期的域， to_char却不会，因为YYYY-MM-DD (IYYY-IDDD) 这种输出格式也会有用。但是避免写类似IYYY-MM-DD的东西，那会得到在 起始年附近令人惊讶的结果。</p>
<p>·   在to_timestamp中，毫秒（MS）和微秒（US）域都被用作小数点后的秒位。例如to_timestamp(&lsquo;12.3&rsquo;, &lsquo;SS.MS&rsquo;)不是 3 毫秒, 而是 300，因为该转换把它看做 12 + 0.3 秒。这意味着对于格式SS.MS而言，输入值12.3、12.30和12.300指定了相同数目的毫秒。要得到三毫秒，你必须使用 12.003，转换会把它看做 12 + 0.003 = 12.003 秒。</p>
<p>·   下面是一个更复杂的例子∶to_timestamp(<code>'15:12:02.020.001230'</code>, <code>'HH24:MI:SS.MS.US'</code>)是 15 小时、12 分钟和 2 秒 + 20 毫秒 + 1230微秒 = 2.021230 秒。</p>
<p>·   to_char(&hellip;, &lsquo;ID&rsquo;)的一周中日的编号匹配extract(isodow from &hellip;)函数，但是to_char(&hellip;, &lsquo;D&rsquo;)不匹配extract(dow from &hellip;)的日编号。</p>
<p>·   to_char(interval)格式化HH和HH12为显示在一个 12 小时的时钟上，即零小时和 36 小时输出为12，而HH24会输出完整的小时值，对于间隔它可以超过 23.</p>
<p>表展示了可以用于格式化数字值的模版模式。</p>
<p><strong>表 . 用于数字格式化的模板模式</strong>







<table class="table table-striped">
<thead>
<tr>
<th>模式</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>9</td>
<td>数位（如果无意义可以被删除）</td>
</tr>
<tr>
<td>0</td>
<td>数位（即便没有意义也不会被删除）</td>
</tr>
<tr>
<td>. (period)</td>
<td>小数点</td>
</tr>
<tr>
<td>, (comma)</td>
<td>分组（千）分隔符</td>
</tr>
<tr>
<td>PR</td>
<td>尖括号内的负值</td>
</tr>
<tr>
<td>S</td>
<td>带符号的数字（使用区域）</td>
</tr>
<tr>
<td>L</td>
<td>货币符号（使用区域）</td>
</tr>
<tr>
<td>D</td>
<td>小数点（使用区域）</td>
</tr>
<tr>
<td>G</td>
<td>分组分隔符（使用区域）</td>
</tr>
<tr>
<td>MI</td>
<td>在指定位置的负号（如果数字 &lt; 0）</td>
</tr>
<tr>
<td>PL</td>
<td>在指定位置的正号（如果数字 &gt; 0）</td>
</tr>
<tr>
<td>SG</td>
<td>在指定位置的正/负号</td>
</tr>
<tr>
<td>RN</td>
<td>罗马数字（输入在 1 和 3999 之间）</td>
</tr>
<tr>
<td>TH or th</td>
<td>序数后缀</td>
</tr>
<tr>
<td>V</td>
<td>移动指定位数（参阅注解）</td>
</tr>
<tr>
<td>EEEE</td>
<td>科学记数的指数</td>
</tr>
</tbody>
</table>
</p>
<p>数字格式化的用法须知：</p>
<p>·   0指定一个总是被打印的数位，即便它包含前导/拖尾的零。9也指定一个数位，但是如果它是前导零则会被空格替换，而如果是拖尾零并且指定了填充模式则它会被删除（对于to_number()来说，这两种模式字符等效）。</p>
<p>·   模式字符S、L、D以及G表示当前locale定义的负号、货币符号、小数点以及数字分隔符字符。不管locale是什么，模式字符句号和逗号就表示小数点和数字分隔符。</p>
<p>·   对于to_char()的模式中的一个负号，如果没有明确的规定，将为该负号保留一列，并且它将被锚接到（出现在左边）那个数字。如果S正好出现在某个9的左边，它也将被锚接到那个数字。</p>
<p>·   使用SG、PL或MI格式化的符号并不挂在数字上面； 例如，to_char(-12, &lsquo;MI9999&rsquo;)生成&rsquo;- 12&rsquo;，而to_char(-12, &lsquo;S9999&rsquo;)生成 &rsquo; -12&rsquo;。（Oracle 里的实现不允许在9前面使用MI，而是要求9在MI前面。）</p>
<p>·   TH不会转换小于零的数值，也不会转换小数。</p>
<p>·   在to_number中，如果没有使用L或TH之类的非数据模板模式，相应数量的输入字符会被跳过，不管它们是否匹配模板模式，除非它们是数据字符（也就是数位、负号、小数点或者逗号）。例如，TH会跳过两个非数据字符。</p>
<p>·   带有to_char的V会把输入值乘上10^n，其中n是跟在V后面的位数。带有to_number的V以类似的方式做除法。to_char和to_number不支持使用结合小数点的V（例如，不允许99.9V99）。</p>
<p>·   EEEE（科学记数法）不能和任何其他格式化模式或修饰语（数字和小数点模式除外）组合在一起使用，并且必须位于格式化字符串的最后（例如9.99EEEE是一个合法的模式）。</p>
<p>某些修饰语可以被应用到任何模板来改变其行为。例如，FM99.99是带有FM修饰语的99.99模式。</p>
<p><strong>表.  用于数字格式化的模板模式修饰语</strong>







<table class="table table-striped">
<thead>
<tr>
<th>修饰语</th>
<th>描述</th>
<th>例子</th>
</tr>
</thead>
<tbody>
<tr>
<td>FM prefix</td>
<td>填充模式（抑制拖尾零和填充的空白）</td>
<td>FM99.99</td>
</tr>
<tr>
<td>TH suffix</td>
<td>大写序数后缀</td>
<td>999TH</td>
</tr>
<tr>
<td>th suffix</td>
<td>小写序数后缀</td>
<td>999th</td>
</tr>
</tbody>
</table>
</p>
<p>表展示了一些使用to_char函数的例子。</p>
<p><strong>表.  to_char例子</strong>







<table class="table table-striped">
<thead>
<tr>
<th>表达式</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>to_char(current_timestamp,  <code>'Day, DD HH12:MI:SS'</code>)</td>
<td><code>'Tuesday , 06 05:39:18'</code></td>
</tr>
<tr>
<td>to_char(current_timestamp,  <code>'FMDay, FMDD HH12:MI:SS'</code>)</td>
<td><code>'Tuesday, 6 05:39:18'</code></td>
</tr>
<tr>
<td>to_char(-0.1, &lsquo;99.99&rsquo;)</td>
<td>&rsquo; -.10'</td>
</tr>
<tr>
<td>to_char(-0.1, &lsquo;FM9.99&rsquo;)</td>
<td>&lsquo;-.1&rsquo;</td>
</tr>
<tr>
<td>to_char(-0.1, &lsquo;FM90.99&rsquo;)</td>
<td>&lsquo;-0.1&rsquo;</td>
</tr>
<tr>
<td>to_char(0.1, &lsquo;0.9&rsquo;)</td>
<td>&rsquo; 0.1'</td>
</tr>
<tr>
<td>to_char(12, &lsquo;9990999.9&rsquo;)</td>
<td>&rsquo;  0012.0'</td>
</tr>
<tr>
<td>to_char(12, &lsquo;FM9990999.9&rsquo;)</td>
<td>&lsquo;0012.&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;999&rsquo;)</td>
<td>&rsquo; 485'</td>
</tr>
<tr>
<td>to_char(-485, &lsquo;999&rsquo;)</td>
<td>&lsquo;-485&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;9 9 9&rsquo;)</td>
<td>&rsquo; 4 8 5'</td>
</tr>
<tr>
<td>to_char(1485, &lsquo;9,999&rsquo;)</td>
<td>&rsquo; 1,485'</td>
</tr>
<tr>
<td>to_char(1485, &lsquo;9G999&rsquo;)</td>
<td>&rsquo; 1 485'</td>
</tr>
<tr>
<td>to_char(148.5, &lsquo;999.999&rsquo;)</td>
<td>&rsquo; 148.500'</td>
</tr>
<tr>
<td>to_char(148.5, &lsquo;FM999.999&rsquo;)</td>
<td>&lsquo;148.5&rsquo;</td>
</tr>
<tr>
<td>to_char(148.5, &lsquo;FM999.990&rsquo;)</td>
<td>&lsquo;148.500&rsquo;</td>
</tr>
<tr>
<td>to_char(148.5, &lsquo;999D999&rsquo;)</td>
<td>&rsquo; 148,500'</td>
</tr>
<tr>
<td>to_char(3148.5, &lsquo;9G999D999&rsquo;)</td>
<td>&rsquo; 3 148,500'</td>
</tr>
<tr>
<td>to_char(-485, &lsquo;999S&rsquo;)</td>
<td>&lsquo;485-&rsquo;</td>
</tr>
<tr>
<td>to_char(-485, &lsquo;999MI&rsquo;)</td>
<td>&lsquo;485-&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;999MI&rsquo;)</td>
<td>&lsquo;485 '</td>
</tr>
<tr>
<td>to_char(485, &lsquo;FM999MI&rsquo;)</td>
<td>&lsquo;485&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;PL999&rsquo;)</td>
<td>&lsquo;+485&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;SG999&rsquo;)</td>
<td>&lsquo;+485&rsquo;</td>
</tr>
<tr>
<td>to_char(-485, &lsquo;SG999&rsquo;)</td>
<td>&lsquo;-485&rsquo;</td>
</tr>
<tr>
<td>to_char(-485, &lsquo;9SG99&rsquo;)</td>
<td>&lsquo;4-85&rsquo;</td>
</tr>
<tr>
<td>to_char(-485, &lsquo;999PR&rsquo;)</td>
<td>&lsquo;&lt;485&gt;&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;L999&rsquo;)</td>
<td>&lsquo;DM 485&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;RN&rsquo;)</td>
<td>&rsquo;    CDLXXXV&rsquo;</td>
</tr>
<tr>
<td>to_char(485, &lsquo;FMRN&rsquo;)</td>
<td>&lsquo;CDLXXXV&rsquo;</td>
</tr>
<tr>
<td>to_char(5.2, &lsquo;FMRN&rsquo;)</td>
<td>&lsquo;V&rsquo;</td>
</tr>
<tr>
<td>to_char(482, &lsquo;999th&rsquo;)</td>
<td>&rsquo; 482nd'</td>
</tr>
<tr>
<td>to_char(485,  &lsquo;&ldquo;Good number:&ldquo;999&rsquo;)</td>
<td>&lsquo;Good number: 485&rsquo;</td>
</tr>
<tr>
<td>to_char(485.8,  &lsquo;&ldquo;Pre:&ldquo;999&rdquo; Post:&rdquo; .999&rsquo;)</td>
<td>&lsquo;Pre: 485 Post: .800&rsquo;</td>
</tr>
<tr>
<td>to_char(12, &lsquo;99V999&rsquo;)</td>
<td>&rsquo; 12000'</td>
</tr>
<tr>
<td>to_char(12.4, &lsquo;99V999&rsquo;)</td>
<td>&rsquo; 12400'</td>
</tr>
<tr>
<td>to_char(12.45, &lsquo;99V9&rsquo;)</td>
<td>&rsquo; 125'</td>
</tr>
<tr>
<td>to_char(0.0004859, &lsquo;9.99EEEE&rsquo;)</td>
<td>&rsquo; 4.86e-04'</td>
</tr>
</tbody>
</table>
</p>
<h2 id="时间日期函数和操作符">时间/日期函数和操作符 <a href="#%e6%97%b6%e9%97%b4%e6%97%a5%e6%9c%9f%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>表展示了可用于处理日期/时间值的函数，其细节在随后的小节中描述。表演示了基本算术操作符 （+、*等）的行为。</p>
<p>所有下文描述的接受time或timestamp输入的函数和操作符实际上都有两种变体： 一种接收time with time zone或timestamp with time zone， 另外一种接受time without time zone或者 timestamp without time zone。为了简化，这些变种没有被独立地展示。此外，+和*操作符都是可交换的操作符对（例如，date + integer 和 integer + date）；我们只显示其中一个。</p>
<p><strong>表  日期/时间操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>操作符</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>+</td>
<td>date &lsquo;2001-09-28&rsquo; + integer &lsquo;7&rsquo;</td>
<td>date &lsquo;2001-10-05&rsquo;</td>
</tr>
<tr>
<td>+</td>
<td>date &lsquo;2001-09-28&rsquo; + interval &lsquo;1 hour&rsquo;</td>
<td><code>timestamp '2001-09-28 01:00:00'</code></td>
</tr>
<tr>
<td>+</td>
<td>date &lsquo;2001-09-28&rsquo; + time &lsquo;03:00&rsquo;</td>
<td><code>timestamp '2001-09-28 03:00:00'</code></td>
</tr>
<tr>
<td>+</td>
<td>interval &lsquo;1 day&rsquo; + interval &lsquo;1 hour&rsquo;</td>
<td><code>interval '1 day 01:00:00'</code></td>
</tr>
<tr>
<td>+</td>
<td>timestamp &lsquo;2001-09-28 01:00&rsquo; + interval &lsquo;23 hours&rsquo;</td>
<td><code>timestamp '2001-09-29 00:00:00'</code></td>
</tr>
<tr>
<td>+</td>
<td>time &lsquo;01:00&rsquo; + interval &lsquo;3 hours&rsquo;</td>
<td><code>time '04:00:00'</code></td>
</tr>
<tr>
<td>-</td>
<td>- interval &lsquo;23 hours&rsquo;</td>
<td><code>interval '-23:00:00'</code></td>
</tr>
<tr>
<td>-</td>
<td>date &lsquo;2001-10-01&rsquo; - date &lsquo;2001-09-28&rsquo;</td>
<td>integer &lsquo;3&rsquo; (days)</td>
</tr>
<tr>
<td>-</td>
<td>date &lsquo;2001-10-01&rsquo; - integer &lsquo;7&rsquo;</td>
<td>date &lsquo;2001-09-24&rsquo;</td>
</tr>
<tr>
<td>-</td>
<td>date &lsquo;2001-09-28&rsquo; - interval &lsquo;1 hour&rsquo;</td>
<td><code>timestamp '2001-09-27 23:00:00'</code></td>
</tr>
<tr>
<td>-</td>
<td>time &lsquo;05:00&rsquo; - time &lsquo;03:00&rsquo;</td>
<td><code>interval '02:00:00'</code></td>
</tr>
<tr>
<td>-</td>
<td>time &lsquo;05:00&rsquo; - interval &lsquo;2 hours&rsquo;</td>
<td><code>time '03:00:00'</code></td>
</tr>
<tr>
<td>-</td>
<td>timestamp &lsquo;2001-09-28 23:00&rsquo; - interval &lsquo;23  hours&rsquo;</td>
<td><code>timestamp '2001-09-28 00:00:00'</code></td>
</tr>
<tr>
<td>-</td>
<td>interval &lsquo;1 day&rsquo; - interval &lsquo;1 hour&rsquo;</td>
<td><code>interval '1 day -01:00:00'</code></td>
</tr>
<tr>
<td>-</td>
<td>timestamp &lsquo;2001-09-29 03:00&rsquo; - timestamp  &lsquo;2001-09-27 12:00&rsquo;</td>
<td><code>interval '1 day 15:00:00'</code></td>
</tr>
<tr>
<td>*</td>
<td>900 * interval &lsquo;1 second&rsquo;</td>
<td><code>interval '00:15:00'</code></td>
</tr>
<tr>
<td>*</td>
<td>21 * interval &lsquo;1 day&rsquo;</td>
<td>interval &lsquo;21 days&rsquo;</td>
</tr>
<tr>
<td>*</td>
<td>double precision &lsquo;3.5&rsquo; * interval &lsquo;1 hour&rsquo;</td>
<td><code>interval '03:30:00'</code></td>
</tr>
<tr>
<td>/</td>
<td>interval &lsquo;1 hour&rsquo; / double precision &lsquo;1.5&rsquo;</td>
<td><code>interval '00:40:00'</code></td>
</tr>
</tbody>
</table>
</p>
<p><strong>表.  日期/时间函数</strong></p>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>age(timestamp, timestamp)</td>
<td>interval</td>
<td>减去参数，生成一个使用年、月（而不是只用日）的“符号化”的结果</td>
<td>age(timestamp &lsquo;2001-04-10&rsquo;, timestamp  &lsquo;1957-06-13&rsquo;)</td>
<td>43 年 9 月 27 日</td>
</tr>
<tr>
<td>age(timestamp)</td>
<td>interval</td>
<td>从current_date（在午夜）减去</td>
<td>age(timestamp &lsquo;1957-06-13&rsquo;)</td>
<td>43 years 8 mons 3 days</td>
</tr>
<tr>
<td>clock_timestamp()</td>
<td>timestamp with time zone</td>
<td>当前日期和时间（在语句执行期间变化）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>current_date</td>
<td>date</td>
<td>当前日期；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>current_time</td>
<td>time with time zone</td>
<td>当前时间（一天中的时间）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>current_timestamp</td>
<td>timestamp with time zone</td>
<td>当前日期和时间（当前事务开始时）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>date_part(text, timestamp)</td>
<td>double precision</td>
<td>获得子域（等价于extract）；</td>
<td><code>date_part('hour', timestamp '2001-02-16  20:38:40')</code></td>
<td>20</td>
</tr>
<tr>
<td>date_part(text, interval)</td>
<td>double precision</td>
<td>获得子域（等价于extract）；</td>
<td>date_part(&lsquo;month&rsquo;, interval &lsquo;2 years 3  months&rsquo;)</td>
<td>3</td>
</tr>
<tr>
<td>date_trunc(text, timestamp)</td>
<td>timestamp</td>
<td>截断到指定精度；</td>
<td><code>date_trunc('hour', timestamp '2001-02-16  20:38:40')</code></td>
<td><code>2001-02-16 20:00:00</code></td>
</tr>
<tr>
<td>date_trunc(text, interval)</td>
<td>interval</td>
<td>截断到指定精度；</td>
<td>date_trunc(&lsquo;hour&rsquo;, interval &lsquo;2 days 3 hours  40 minutes&rsquo;)</td>
<td><code>2 days 03:00:00</code></td>
</tr>
<tr>
<td>extract(field from timestamp)</td>
<td>double precision</td>
<td>获得子域；</td>
<td><code>extract(hour from timestamp '2001-02-16  20:38:40')</code></td>
<td>20</td>
</tr>
<tr>
<td>extract(field from interval)</td>
<td>double precision</td>
<td>获得子域；</td>
<td>extract(month from interval &lsquo;2 years 3  months&rsquo;)</td>
<td>3</td>
</tr>
<tr>
<td>isfinite(date)</td>
<td>boolean</td>
<td>测试有限日期（不是+/-无限）</td>
<td>isfinite(date &lsquo;2001-02-16&rsquo;)</td>
<td>true</td>
</tr>
<tr>
<td>isfinite(timestamp)</td>
<td>boolean</td>
<td>测试有限时间戳（不是+/-无限）</td>
<td><code>isfinite(timestamp '2001-02-16 21:28:30')</code></td>
<td>true</td>
</tr>
<tr>
<td>isfinite(interval)</td>
<td>boolean</td>
<td>测试有限间隔</td>
<td>isfinite(interval &lsquo;4 hours&rsquo;)</td>
<td>true</td>
</tr>
<tr>
<td>justify_days(interval)</td>
<td>interval</td>
<td>调整间隔这样30天时间周期可以表示为月</td>
<td>justify_days(interval &lsquo;35 days&rsquo;)</td>
<td>1 mon 5 days</td>
</tr>
<tr>
<td>justify_hours(interval)</td>
<td>interval</td>
<td>调整间隔这样24小时时间周期可以表示为日</td>
<td>justify_hours(interval &lsquo;27 hours&rsquo;)</td>
<td><code>1 day 03:00:00</code></td>
</tr>
<tr>
<td>justify_interval(interval)</td>
<td>interval</td>
<td>使用justify_days和justify_hours调整间隔，使用额外的符号调整</td>
<td>justify_interval(interval &lsquo;1 mon -1 hour&rsquo;)</td>
<td><code>29 days 23:00:00</code></td>
</tr>
<tr>
<td>localtime</td>
<td>time</td>
<td>当前时间（一天中的时间）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>localtimestamp</td>
<td>timestamp</td>
<td>当前日期和时间（当前事务的开始）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>make_date(year int, month int, day int)</td>
<td>date</td>
<td>从年、月、日域创建日期</td>
<td>make_date(2013, 7, 15)</td>
<td>2013-07-15</td>
</tr>
<tr>
<td>make_interval(years int DEFAULT  0, months int DEFAULT 0, weeks int DEFAULT  0, days int DEFAULT 0, hours int DEFAULT  0, mins int DEFAULT 0, secs double precision DEFAULT  0.0)</td>
<td>interval</td>
<td>从年、月、周、日、时、分、秒域创建 interval</td>
<td>make_interval(days =&gt; 10)</td>
<td>10 days</td>
</tr>
<tr>
<td>make_time(hour int, min int, sec double  precision)</td>
<td>time</td>
<td>从时、分、秒域创建时间</td>
<td>make_time(8, 15, 23.5)</td>
<td><code>08:15:23.5</code></td>
</tr>
<tr>
<td>make_timestamp(year int, month int, day int, hour int, min int, sec double  precision)</td>
<td>timestamp</td>
<td>从年、月、日、时、分、秒域创建时间戳</td>
<td>make_timestamp(2013, 7, 15, 8, 15, 23.5)</td>
<td><code>2013-07-15 08:15:23.5</code></td>
</tr>
<tr>
<td>make_timestamptz(year int, month int, day int, hour int, min int, sec double  precision, [ timezone text ])</td>
<td>timestamp with time zone</td>
<td>从年、月、日、时、分、秒域创建带时区的时间戳。如果没有指定timezone， 则使用当前时区。</td>
<td>make_timestamptz(2013, 7, 15, 8, 15, 23.5)</td>
<td><code>2013-07-15 08:15:23.5+01</code></td>
</tr>
<tr>
<td>now()</td>
<td>timestamp with time zone</td>
<td>当前日期和时间（当前事务的开始）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>statement_timestamp()</td>
<td>timestamp with time zone</td>
<td>当前日期和时间（当前事务的开始）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>timeofday()</td>
<td>text</td>
<td>当前日期和时间（像clock_timestamp，但是作为一个text字符串）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>transaction_timestamp()</td>
<td>timestamp with time zone</td>
<td>当前日期和时间（当前事务的开始）；</td>
<td></td>
<td></td>
</tr>
<tr>
<td>to_timestamp(double precision)</td>
<td>timestamp with time zone</td>
<td>把 Unix 时间（从 1970-01-01 00:00:00+00 开始的秒）转换成 timestamp</td>
<td>to_timestamp(1284352323)</td>
<td><code>2010-09-13 04:32:03+00</code></td>
</tr>
</tbody>
</table>

<p>除了这些函数以外，还支持 SQL 操作符OVERLAPS：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="3538bc5" class="language- ">
  <code>(start1, end1) OVERLAPS (start2, end2)
(start1, length1) OVERLAPS (start2, length2)</code>
  </pre>
  </div>
<p>这个表达式在两个时间域（用它们的端点定义）重叠的时候得到真，当它们不重叠时得到假。端点可以用一对日期、时间或者时间戳来指定；或者是用一个后面跟着一个间隔的日期、时间或时间戳来指定。当一对值被提供时，起点或终点都可以被写在前面，OVERLAPS会自动地把较早的值作为起点。每一个时间段被认为是表示半开的间隔start &lt;= time &lt; end，除非start和end相等，这种情况下它表示单个时间实例。例如这表示两个只有一个共同端点的时间段不重叠。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="36f9e17" class="language- ">
  <code>SELECT (DATE &#39;2001-02-16&#39;, DATE &#39;2001-12-21&#39;) OVERLAPS
       (DATE &#39;2001-10-30&#39;, DATE &#39;2002-10-30&#39;);
结果：true
SELECT (DATE &#39;2001-02-16&#39;, INTERVAL &#39;100 days&#39;) OVERLAPS
       (DATE &#39;2001-10-30&#39;, DATE &#39;2002-10-30&#39;);
结果：false
SELECT (DATE &#39;2001-10-29&#39;, DATE &#39;2001-10-30&#39;) OVERLAPS
       (DATE &#39;2001-10-30&#39;, DATE &#39;2001-10-31&#39;);
结果：false
SELECT (DATE &#39;2001-10-30&#39;, DATE &#39;2001-10-30&#39;) OVERLAPS
       (DATE &#39;2001-10-30&#39;, DATE &#39;2001-10-31&#39;);
结果：true</code>
  </pre>
  </div>
<p>当把一个interval值添加到timestamp with time zone上（或从中减去）时， days 部分会按照指定的天数增加或减少timestamp with time zone的日期。 对于横跨夏令时的变化（当会话的时区被设置为可识别DST的时区时），这意味着interval &lsquo;1 day&rsquo;并 不一定等于interval &lsquo;24 hours&rsquo;。例如，当会话的时区设置为CST7CDT时，timestamp with time zone &lsquo;2005-04-02 12:00-07&rsquo; + interval &lsquo;1 day&rsquo; 的结果是timestamp with time zone &lsquo;2005-04-03 12:00-06&rsquo;，而将interval &lsquo;24 hours&rsquo;增加到相同的初始timestamp with time zone的结果 则是timestamp with time zone &lsquo;2005-04-03 13:00-06&rsquo;， 因为CST7CDT时区在2005-04-03 02:00有一个夏令时变更。</p>
<p>注意age返回的月数域可能有歧义，因为不同的月份有不同的天数。当计算部分月数时，采用两个日期中较早的月。例如：age(&lsquo;2004-06-01&rsquo;, &lsquo;2004-04-30&rsquo;)使用4月份得到1 mon 1 day，而用5月分时会得到1 mon 2 days，因为5月有31天，而4月只有30天。</p>
<p>日期和时间戳的减法也可能会很复杂。执行减法的一种概念上很简单的方法是，使用 EXTRACT(EPOCH FROM &hellip;)把每个值都转换成秒数，然后执行减法， 这样会得到两个值之间的<em>秒</em>数。这种方法将会适应每个月中天数、 时区改变和夏令时调整。使用“-”操作符的日期或时间 戳减法会返回值之间的天数（24小时）以及时/分/秒，也会做同样的调整。 age函数会返回年、月、日以及时/分/秒，执行按域的减法，然后对 负值域进行调整。下面的查询展示了这些方法的不同。例子中的结果由 timezone = &lsquo;US/Eastern&rsquo;产生，这使得两个使用的日期之间存在着夏令 时的变化：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="d54a8d8" class="language- ">
  <code>SELECT EXTRACT(EPOCH FROM timestamptz &#39;2013-07-01 12:00:00&#39;) -
       EXTRACT(EPOCH FROM timestamptz &#39;2013-03-01 12:00:00&#39;);
Result: 10537200
SELECT (EXTRACT(EPOCH FROM timestamptz &#39;2013-07-01 12:00:00&#39;) -
        EXTRACT(EPOCH FROM timestamptz &#39;2013-03-01 12:00:00&#39;))
        / 60 / 60 / 24;
Result: 121.958333333333
SELECT timestamptz &#39;2013-07-01 12:00:00&#39; - timestamptz &#39;2013-03-01 12:00:00&#39;;
Result: 121 days 23:00:00
SELECT age(timestamptz &#39;2013-07-01 12:00:00&#39;, timestamptz &#39;2013-03-01 12:00:00&#39;);
Result: 4 mons</code>
  </pre>
  </div>
<h3 id="extract-date_part">EXTRACT, date_part <a href="#extract-date_part" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="0127ba4" class="language- ">
  <code>EXTRACT(field FROM source)</code>
  </pre>
  </div>
<p>extract函数从日期/时间值中抽取子域，例如年或者小时等。source必须是一个类型 timestamp、time或interval的值表达式（类型为date的表达式将被造型为 timestamp，并且因此也可以被同样使用）。field是一个标识符或者字符串，它指定从源值中抽取的域。extract函数返回类型为double precision的值。 下列值是有效的域名字∶</p>
<p>century</p>
<p>世纪</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e93b333" class="language- ">
  <code>SELECT EXTRACT(CENTURY FROM TIMESTAMP &#39;2000-12-16 12:21:13&#39;);
结果：20
SELECT EXTRACT(CENTURY FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：21</code>
  </pre>
  </div>
<p>第一个世纪从 <code>0001-01-01 00:00:00 AD</code> 开始， 尽管那时候人们还不知道这是第一个世纪。这个定义适用于所有使用格里高利历法的国家。其中没有 0 世纪，我们直接从公元前 1 世纪到公元 1 世纪。 如果你认为这个不合理，那么请把抱怨发给：罗马圣彼得教堂，梵蒂冈，教皇收。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="a056cf8" class="language- ">
  <code>day</code>
  </pre>
  </div>
<p>对于timestamp值，是（月份）里的日域（1-31）；对于interval值，是日数</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="f14d689" class="language- ">
  <code>SELECT EXTRACT(DAY FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：16
 
SELECT EXTRACT(DAY FROM INTERVAL &#39;40 days 1 minute&#39;);
结果：40
decade</code>
  </pre>
  </div>
<p>年份域除以10</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="3cdac3f" class="language- ">
  <code>SELECT EXTRACT(DECADE FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：200
dow</code>
  </pre>
  </div>
<p>一周中的日，从周日（0）到周六（6）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="38f1d71" class="language- ">
  <code>SELECT EXTRACT(DOW FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：5</code>
  </pre>
  </div>
<p>请注意，extract的一周中的日和to_char(&hellip;, &lsquo;D&rsquo;)函数不同。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="dfa0e0d" class="language- ">
  <code>doy</code>
  </pre>
  </div>
<p>一年的第几天（1 -365/366）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="a673a60" class="language- ">
  <code>SELECT EXTRACT(DOY FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：47
epoch</code>
  </pre>
  </div>
<p>对于timestamp with time zone值， 是自<code>1970-01-01 00:00:00 UTC</code>以来的秒数（结果可能是负数）； 对于date and timestamp值，是自本地时间<code> 1970-01-01 00:00:00</code> 以来的描述；对于interval值，它是时间间隔的总秒数。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="23d2554" class="language- ">
  <code>SELECT EXTRACT(EPOCH FROM TIMESTAMP WITH TIME ZONE &#39;2001-02-16 20:38:40.12-08&#39;);
结果：982384720.12
 
SELECT EXTRACT(EPOCH FROM INTERVAL &#39;5 days 3 hours&#39;);
结果：442800</code>
  </pre>
  </div>
<p>不能用to_timestamp把一个 epoch 值转换回成时间戳：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="3c9659c" class="language- ">
  <code>SELECT to_timestamp(982384720.12);
Result: 2001-02-17 04:38:40.12&#43;00
hour</code>
  </pre>
  </div>
<p>小时域（0 - 23）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4e50dd2" class="language- ">
  <code>SELECT EXTRACT(HOUR FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：20
isodow</code>
  </pre>
  </div>
<p>一周中的日，从周一（1）到周日（7）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="d9a35eb" class="language- ">
  <code>SELECT EXTRACT(ISODOW FROM TIMESTAMP &#39;2001-02-18 20:38:40&#39;);
结果：7</code>
  </pre>
  </div>
<p>除了周日，这和dow相同。这符合ISO 8601 中一周中的日的编号。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="5b3a6dd" class="language- ">
  <code>isoyear</code>
  </pre>
  </div>
<p>日期所落在的ISO 8601 周编号的年（不适用于间隔）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="b4ca93a" class="language- ">
  <code>SELECT EXTRACT(ISOYEAR FROM DATE &#39;2006-01-01&#39;);
结果：2005
SELECT EXTRACT(ISOYEAR FROM DATE &#39;2006-01-02&#39;);
结果：2006</code>
  </pre>
  </div>
<p>每一个ISO 8601 周编号的年都开始于包含1月4日的那一周的周一，在早的1月或迟的12月中ISO年可能和格里高利年不同。更多信息见week域。</p>
<p>这个域不能用于 PostgreSQL 8.3之前的版本。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e3052c7" class="language- ">
  <code>microseconds</code>
  </pre>
  </div>
<p>秒域，包括小数部分，乘以 1,000,000。请注意它包括全部的秒</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4bf260f" class="language- ">
  <code>SELECT EXTRACT(MICROSECONDS FROM TIME &#39;17:12:28.5&#39;);
结果：28500000
millennium</code>
  </pre>
  </div>
<p>千年</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="1e92ebe" class="language- ">
  <code>SELECT EXTRACT(MILLENNIUM FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：3</code>
  </pre>
  </div>
<p>19xx的年份在第二个千年里。第三个千年从 2001 年 1 月 1 日开始。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="5bc72b5" class="language- ">
  <code>milliseconds</code>
  </pre>
  </div>
<p>秒域，包括小数部分，乘以 1000。请注意它包括完整的秒。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4d71cb1" class="language- ">
  <code>SELECT EXTRACT(MILLISECONDS FROM TIME &#39;17:12:28.5&#39;);
结果：28500
minute</code>
  </pre>
  </div>
<p>分钟域（0 - 59）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="534c71f" class="language- ">
  <code>SELECT EXTRACT(MINUTE FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：38
month</code>
  </pre>
  </div>
<p>对于timestamp值，它是一年里的月份数（1 - 12）； 对于interval值，它是月的数目，然后对 12 取模（0 - 11）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="667e238" class="language- ">
  <code>SELECT EXTRACT(MONTH FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：2
 
SELECT EXTRACT(MONTH FROM INTERVAL &#39;2 years 3 months&#39;);
结果：3
 
SELECT EXTRACT(MONTH FROM INTERVAL &#39;2 years 13 months&#39;);
结果：1
quarter</code>
  </pre>
  </div>
<p>该天所在的该年的季度（1 - 4）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2086857" class="language- ">
  <code>SELECT EXTRACT(QUARTER FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：1
second</code>
  </pre>
  </div>
<p>秒域，包括小数部分（0 - 59[<a href="http://postgres.cn/docs/11/functions-datetime.html#ftn.id-1.5.8.14.12.5.11.16.2.1.1" rel="external" target="_blank">7]<svg width="16" height="16" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" d="M14 5c-.552 0-1-.448-1-1s.448-1 1-1h6c.552 0 1 .448 1 1v6c0 .552-.448 1-1 1s-1-.448-1-1v-3.586l-7.293 7.293c-.391.39-1.024.39-1.414 0-.391-.391-.391-1.024 0-1.414l7.293-7.293h-3.586zm-9 2c-.552 0-1 .448-1 1v11c0 .552.448 1 1 1h11c.552 0 1-.448 1-1v-4.563c0-.552.448-1 1-1s1 .448 1 1v4.563c0 1.657-1.343 3-3 3h-11c-1.657 0-3-1.343-3-3v-11c0-1.657 1.343-3 3-3h4.563c.552 0 1 .448 1 1s-.448 1-1 1h-4.563z"/></svg></a>）</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4f99284" class="language- ">
  <code>SELECT EXTRACT(SECOND FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：40
 
SELECT EXTRACT(SECOND FROM TIME &#39;17:12:28.5&#39;);
结果：28.5
timezone</code>
  </pre>
  </div>
<p>与 UTC 的时区偏移，以秒记。正数对应 UTC 东边的时区，负数对应 UTC 西边的时区（从技术上来看，PostgreSQL不使用 UTC，因为其中不处理闰秒）。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="74e81ec" class="language- ">
  <code>timezone_hour</code>
  </pre>
  </div>
<p>时区偏移的小时部分。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="b8e32cc" class="language- ">
  <code>timezone_minute</code>
  </pre>
  </div>
<p>时区偏移的分钟部分。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="5631808" class="language- ">
  <code>week</code>
  </pre>
  </div>
<p>该天在所在的ISO 8601 周编号的年份里是第几周。根据定义， 一年的第一周包含该年的 1月 4 日并且 ISO 周从星期一开始。换句话说，一年的第一个星期四在第一周。</p>
<p>在 ISO 周编号系统中，早的 1 月的日期可能位于前一年的第五十二或者第五十三周，而迟的 12 月的日期可能位于下一年的第一周。例如， 2005-01-01位于 2004 年的第五十三周，并且2006-01-01位于 2005 年的第五十二周，而2012-12-31位于 2013 年的第一周。我们推荐把isoyear域和week一起使用来得到一致的结果。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2aa5fbf" class="language- ">
  <code>SELECT EXTRACT(WEEK FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：7
year</code>
  </pre>
  </div>
<p>年份域。要记住这里没有0 AD，所以从AD年里抽取BC年应该小心处理。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="faec0f7" class="language- ">
  <code>SELECT EXTRACT(YEAR FROM TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：2001</code>
  </pre>
  </div>
<p>注意</p>
<p>当输入值为 +/-Infinity 时，extract对于单调增的域（epoch、julian、year、isoyear、decade、century以及millennium）返回 +/-Infinity。对于其他域返回 NULL。PostgreSQL 9.6 之前的版本对所有输入无穷的情况都返回零。</p>
<p>在传统的Ingres上建模的date_part函数等价于SQL标准函数extract：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="d8b5efd" class="language- ">
  <code>date_part(&#39;field&#39;, source)</code>
  </pre>
  </div>
<p>请注意这里的field参数必须是一个串值，而不是一个名字。有效的date_part域名 和extract相同。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="905802c" class="language- ">
  <code>SELECT date_part(&#39;day&#39;, TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：16
 
SELECT date_part(&#39;hour&#39;, INTERVAL &#39;4 hours 3 minutes&#39;);
结果：4</code>
  </pre>
  </div>
<h3 id="date_trunc">date_trunc <a href="#date_trunc" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>date_trunc函数在概念上和用于数字的trunc函数类似。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="23c69b3" class="language- ">
  <code>date_trunc(&#39;field&#39;, source)</code>
  </pre>
  </div>
<p>source是类型timestamp或interval的值表达式（类型date和 time的值都分别被自动转换成timestamp或者interval）。field选择对输入值选用什么样的精度进行截断。返回的值是timestamp类型或者所有小于选定的 精度的域都设置为零（或者一，对于日期和月份）的interval。</p>
<p>field的有效值是∶







<table class="table table-striped">
<thead>
<tr>
<th>microseconds</th>
</tr>
</thead>
<tbody>
<tr>
<td>milliseconds</td>
</tr>
<tr>
<td>second</td>
</tr>
<tr>
<td>minute</td>
</tr>
<tr>
<td>hour</td>
</tr>
<tr>
<td>day</td>
</tr>
<tr>
<td>week</td>
</tr>
<tr>
<td>month</td>
</tr>
<tr>
<td>quarter</td>
</tr>
<tr>
<td>year</td>
</tr>
<tr>
<td>decade</td>
</tr>
<tr>
<td>century</td>
</tr>
<tr>
<td>millennium</td>
</tr>
</tbody>
</table>

例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="9862af7" class="language- ">
  <code>SELECT date_trunc(&#39;hour&#39;, TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：2001-02-16 20:00:00
 
SELECT date_trunc(&#39;year&#39;, TIMESTAMP &#39;2001-02-16 20:38:40&#39;);
结果：2001-01-01 00:00:00</code>
  </pre>
  </div>
<h3 id="at-time-zone">AT TIME ZONE <a href="#at-time-zone" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>AT TIME ZONE把时间戳<em>without time zone</em>转换成时间戳<em>with time zone</em>或者反过来，并且把<em>time</em>值转换成不同的时区。表展示了它的变体。</p>
<p><strong>表</strong> <strong>.</strong> AT TIME ZONE<strong>变体</strong>







<table class="table table-striped">
<thead>
<tr>
<th>表达式</th>
<th>返回类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>timestamp without time zone AT TIME  ZONE zone</td>
<td>timestamp with time zone</td>
<td>把给定的不带时区的时间戳当作位于指定时区的时间对待</td>
</tr>
<tr>
<td>timestamp with time zone AT TIME  ZONE zone</td>
<td>timestamp without time zone</td>
<td>把给定的带时区的时间戳转换到新的时区，不带时区指定</td>
</tr>
<tr>
<td>time with time zone AT TIME  ZONE zone</td>
<td>time with time zone</td>
<td>把给定的带时区的时间转换到新时区</td>
</tr>
</tbody>
</table>
</p>
<p>在这些表达式里，我们需要的时区zone可以指定为文本串（例如，&lsquo;America/Los_Angeles&rsquo;）或者一个间隔 （例如，INTERVAL &lsquo;-08:00&rsquo;）。</p>
<p>例子（假设本地时区是America/Los_Angeles）：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="dd2ec2b" class="language- ">
  <code>SELECT TIMESTAMP &#39;2001-02-16 20:38:40&#39; AT TIME ZONE &#39;America/Denver&#39;;
Result: 2001-02-16 19:38:40-08
 
SELECT TIMESTAMP WITH TIME ZONE &#39;2001-02-16 20:38:40-05&#39; AT TIME ZONE &#39;America/Denver&#39;;
Result: 2001-02-16 18:38:40
 
SELECT TIMESTAMP &#39;2001-02-16 20:38:40-05&#39; AT TIME ZONE &#39;Asia/Tokyo&#39; AT TIME ZONE &#39;America/Chicago&#39;;
Result: 2001-02-16 05:38:40</code>
  </pre>
  </div>
<p>第一个例子给缺少时区的值加上了时区，并且显示了使用当前TimeZone设置的值。第二个例子把带有时区值的时间戳移动到指定的时区，并且返回不带时区的值。这允许存储和显示不同于当前TimeZone设置的值。第三个例子把东京时间转换成芝加哥时间。把<em>time</em>值转换成其他时区会使用当前活跃的时区规则，因为没有提供日期。</p>
<p>函数timezone(zone, timestamp)等效于 SQL 兼容的结构timestamp AT TIME ZONE zone。</p>
<h3 id="当前日期时间">当前日期/时间 <a href="#%e5%bd%93%e5%89%8d%e6%97%a5%e6%9c%9f%e6%97%b6%e9%97%b4" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>MemFireDB提供了许多返回当前日期和时间的函数。这些 SQL 标准的函数全部都按照当前事务的开始时刻返回值：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4733c5e" class="language- ">
  <code>CURRENT_DATE
CURRENT_TIME
CURRENT_TIMESTAMP
CURRENT_TIME(precision)
CURRENT_TIMESTAMP(precision)
LOCALTIME
LOCALTIMESTAMP
LOCALTIME(precision)
LOCALTIMESTAMP(precision)</code>
  </pre>
  </div>
<p>CURRENT_TIME和CURRENT_TIMESTAMP传递带有时区的值；LOCALTIME和LOCALTIMESTAMP传递的值不带时区。</p>
<p>CURRENT_TIME、CURRENT_TIMESTAMP、LOCALTIME和 LOCALTIMESTAMP可以有选择地接受一个精度参数， 该精度导致结果的秒域被园整为指定小数位。如果没有精度参数，结果将被给予所能得到的全部精度。</p>
<p>一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="bdaf380" class="language- ">
  <code>SELECT CURRENT_TIME;
结果：14:39:53.662522-05
 
SELECT CURRENT_DATE;
结果：2001-12-23
 
SELECT CURRENT_TIMESTAMP;
结果：2001-12-23 14:39:53.662522-05
 
SELECT CURRENT_TIMESTAMP(2);
结果：2001-12-23 14:39:53.66-05
 
SELECT LOCALTIMESTAMP;
结果：2001-12-23 14:39:53.662522</code>
  </pre>
  </div>
<p>因为这些函数全部都按照当前事务的开始时刻返回结果，所以它们的值在事务运行的整个期间内都不改变。 我们认为这是一个特性：目的是为了允许一个事务在“当前”时间上有一致的概念， 这样在同一个事务里的多个修改可以保持同样的时间戳。</p>
<p>注意:许多其它数据库系统可能会更频繁地推进这些值。
MemFireDB同样也提供了返回当前语句开始时间的函数， 它们会返回函数被调用时的真实当前时间。这些非 SQL 标准的函数列表如下：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="849f1c5" class="language- ">
  <code>transaction_timestamp()
statement_timestamp()
clock_timestamp()
timeofday()
now()</code>
  </pre>
  </div>
<p><code>transaction_timestamp()</code>等价于<code>CURRENT_TIMESTAMP</code>，但是其命名清楚地反映了它的返回值。statement_timestamp()返回当前语句的开始时刻（更准确的说是收到 客户端最后一条命令的时间）。statement_timestamp()和transaction_timestamp()在一个事务的第一条命令期间返回值相同，但是在随后的命令中却不一定相同。 clock_timestamp()返回真正的当前时间，因此它的值甚至在同一条 SQL 命令中都会变化。timeofday()是一个有历史原因的PostgreSQL函数。和clock_timestamp()相似，timeofday()也返回真实的当前时间，但是它的结果是一个格式化的text串，而不是timestamp with time zone值。now()是PostgreSQL的一个传统，等效于transaction_timestamp()。</p>
<p>所有日期/时间类型还接受特殊的文字值now，用于指定当前的日期和时间（重申，被解释为当前事务的开始时刻）。 因此，下面三个都返回相同的结果：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="87f89e5" class="language- ">
  <code>SELECT CURRENT_TIMESTAMP;
SELECT now();
SELECT TIMESTAMP &#39;now&#39;;  -- 对于和 DEFAULT 一起使用是不正确的</code>
  </pre>
  </div>
<p>提示:在创建表期间指定一个DEFAULT子句时，你不会希望使用第三种形式。系统将在分析这个常量的时候把now转换为一个timestamp， 这样需要默认值时就会得到创建表的时间！而前两种形式要到实际使用缺省值的时候才被计算， 因为它们是函数调用。因此它们可以给出每次插入行的时刻。</p>
<h3 id="延时执行">延时执行 <a href="#%e5%bb%b6%e6%97%b6%e6%89%a7%e8%a1%8c" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>下面的这些函数可以用于让服务器进程延时执行：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="ef906d2" class="language-sql ">
  <code>pg_sleep(seconds)
pg_sleep_for(interval)
pg_sleep_until(timestamp with time zone)</code>
  </pre>
  </div>
<p>pg_sleep让当前的会话进程休眠seconds 秒以后再执行。seconds是一个double precision 类型的值，所以可以指定带小数的秒数。pg_sleep_for是针对用 interval指定的较长休眠时间的函数。pg_sleep_until 则可以用来休眠到一个指定的时刻唤醒。例如：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="f542779" class="language-sql ">
  <code>SELECT pg_sleep(1.5);
SELECT pg_sleep_for(&#39;5 minutes&#39;);
SELECT pg_sleep_until(&#39;tomorrow 03:00&#39;);</code>
  </pre>
  </div>
<h2 id="枚举支持函数">枚举支持函数 <a href="#%e6%9e%9a%e4%b8%be%e6%94%af%e6%8c%81%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>对于枚举类型， 有一些函数允许更清洁的编码，而不需要为一个枚举类型硬写特定的值。它们被列在表 中。本例假定一个枚举类型被创建为：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e666531" class="language- ">
  <code>CREATE TYPE rainbow AS ENUM (&#39;red&#39;, &#39;orange&#39;, &#39;yellow&#39;, &#39;green&#39;, &#39;blue&#39;, &#39;purple&#39;);</code>
  </pre>
  </div>
<p><strong>表. 枚举支持函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>描述</th>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>enum_first(anyenum)</td>
<td>返回输入枚举类型的第一个值</td>
<td>enum_first(null::rainbow)</td>
<td>red</td>
</tr>
<tr>
<td>enum_last(anyenum)</td>
<td>返回输入枚举类型的最后一个值</td>
<td>enum_last(null::rainbow)</td>
<td>purple</td>
</tr>
<tr>
<td>enum_range(anyenum)</td>
<td>将输入枚举类型的所有值作为一个有序的数组返回</td>
<td>enum_range(null::rainbow)</td>
<td>{red,orange,yellow,green,blue,purple}</td>
</tr>
<tr>
<td>enum_range(anyenum, anyenum)</td>
<td>以一个数组返回在给定两个枚举值之间的范围。值必须来自相同的枚举类型。 如果第一个参数为空，其结果将从枚举类型的第一个值开始。如果第二参数为空，其结果将以枚举类型的最后一个值结束。</td>
<td>enum_range(&lsquo;orange&rsquo;::rainbow,  &lsquo;green&rsquo;::rainbow)</td>
<td>{orange,yellow,green}</td>
</tr>
<tr>
<td></td>
<td></td>
<td>enum_range(NULL, &lsquo;green&rsquo;::rainbow)`</td>
<td>{red,orange,yellow,green}</td>
</tr>
<tr>
<td></td>
<td></td>
<td>enum_range(&lsquo;orange&rsquo;::rainbow, NULL)`</td>
<td>{orange,yellow,green,blue,purple}</td>
</tr>
</tbody>
</table>
</p>
<p>请注意，除了双参数形式的enum_range外， 这些函数忽略传递给它们的具体值，它们只关心声明的数据类型。 空值或类型的一个特定值可以通过，并得到相同的结果。这些函数更多地被用于一个表列或函数参数，而不是一个硬写的类型名，如例子中所建议。</p>
<p>枚举样例如下：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="d5873a2" class="language-sql ">
  <code>create type enum_clor as enum (&#39;red&#39;,&#39;black&#39;,&#39;green&#39;,&#39;white&#39;,&#39;blue&#39;);
select enum_first(&#39;black&#39;::enum_clor),enum_first(null::enum_clor);
 
select enum_last(&#39;black&#39;::enum_clor),enum_last(null::enum_clor);
select enum_range(&#39;black&#39;::enum_clor),enum_range(null::enum_clor);
select enum_range(null,&#39;white&#39;::enum_clor);
select enum_range(&#39;black&#39;::enum_clor,null);
select enum_range(&#39;black&#39;::enum_clor,&#39;white&#39;::enum_clor);</code>
  </pre>
  </div>
<h2 id="几何函数和操作符">几何函数和操作符 <a href="#%e5%87%a0%e4%bd%95%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>几何类型point、box、 lseg、line、path、 polygon和circle有一大堆本地支持函数和操作符，如下表中所示。</p>
<p><strong>表</strong> <strong>.</strong> <strong>几何操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>操作符</th>
<th>描述</th>
<th>例子</th>
</tr>
</thead>
<tbody>
<tr>
<td>+</td>
<td>平移</td>
<td>select box &lsquo;((0,0),(1,1))&rsquo; + point &lsquo;(2.0,0)&rsquo;;</td>
</tr>
<tr>
<td>-</td>
<td>平移</td>
<td>select box &lsquo;((0,0),(1,1))&rsquo; - point &lsquo;(2.0,0)&rsquo;;</td>
</tr>
<tr>
<td>*</td>
<td>缩放/旋转</td>
<td>select box &lsquo;((0,0),(1,1))&rsquo; * point &lsquo;(2.0,0)&rsquo;;</td>
</tr>
<tr>
<td>/</td>
<td>缩放/旋转</td>
<td>select box &lsquo;((0,0),(2,2))&rsquo; / point &lsquo;(2.0,0)&rsquo;;</td>
</tr>
<tr>
<td>#</td>
<td>相交的点或方框</td>
<td>select box&rsquo;((1,-1),(-1,1))&rsquo; #  box&rsquo;((1,1),(-1,-1))&rsquo;;</td>
</tr>
<tr>
<td>#</td>
<td>路径或多边形中的点数</td>
<td>select # path &lsquo;((1,0),(0,1),(-1,0))&rsquo;;</td>
</tr>
<tr>
<td>@-@</td>
<td>长度或周长</td>
<td>select @-@ path &lsquo;((0,0),(1,0))&rsquo;;</td>
</tr>
<tr>
<td>@@</td>
<td>中心</td>
<td>select @@ circle &lsquo;((0,0),10)&rsquo;;</td>
</tr>
<tr>
<td>##</td>
<td>第二个操作数上最接近第一个操作数的点</td>
<td>select point &lsquo;(0,0)&rsquo; ## lseg &lsquo;((2,0),(0,2))&rsquo;;</td>
</tr>
<tr>
<td>&lt;-&gt;</td>
<td>距离</td>
<td>select circle &lsquo;((0,0),1)&rsquo; &lt;-&gt; circle  &lsquo;((5,0),1)&rsquo;;</td>
</tr>
<tr>
<td>&amp;&amp;</td>
<td>是否重叠？（只要有一个公共点这就为真）</td>
<td>select box &lsquo;((0,0),(1,1))&rsquo; &amp;&amp; box  &lsquo;((0,0),(2,2))&rsquo;;</td>
</tr>
<tr>
<td>&laquo;</td>
<td>是否严格地在左侧？</td>
<td>select circle &lsquo;((0,0),1)&rsquo; &laquo; circle  &lsquo;((5,0),1)&rsquo;;</td>
</tr>
<tr>
<td>&raquo;</td>
<td>是否严格地在右侧？</td>
<td>select circle &lsquo;((5,0),1)&rsquo; &raquo; circle  &lsquo;((0,0),1)&rsquo;;</td>
</tr>
<tr>
<td>&amp;&lt;</td>
<td>没有延展到右边？</td>
<td>select box &lsquo;((0,0),(1,1))&rsquo; &amp;&lt; box  &lsquo;((0,0),(2,2))&rsquo;;</td>
</tr>
<tr>
<td>&amp;&gt;</td>
<td>没有延展到左边？</td>
<td>select box &lsquo;((0,0),(3,3))&rsquo; &amp;&gt; box  &lsquo;((0,0),(2,2))&rsquo;;</td>
</tr>
<tr>
<td>&laquo;|</td>
<td>严格在下？</td>
<td>select box &lsquo;((0,0),(3,3))&rsquo; &laquo;| box  &lsquo;((3,4),(5,5))&rsquo;;</td>
</tr>
<tr>
<td>|&raquo;</td>
<td>严格在上？</td>
<td>select box &lsquo;((3,4),(5,5))&rsquo; |&raquo; box  &lsquo;((0,0),(3,3))&rsquo;;</td>
</tr>
<tr>
<td>&amp;&lt;|</td>
<td>没有延展到上面？</td>
<td>select box &lsquo;((0,0),(1,1))&rsquo; &amp;&lt;| box  &lsquo;((0,0),(2,2))&rsquo;;</td>
</tr>
<tr>
<td>|&amp;&gt;</td>
<td>没有延展到下面？</td>
<td>select box &lsquo;((0,0),(3,3))&rsquo; |&amp;&gt; box  &lsquo;((0,0),(2,2))&rsquo;;</td>
</tr>
<tr>
<td>&lt;^</td>
<td>在下面（允许相切）？</td>
<td>select circle &lsquo;((0,0),1)&rsquo; &lt;^ circle  &lsquo;((0,5),1)&rsquo;;</td>
</tr>
<tr>
<td>&gt;^</td>
<td>在上面（允许相切）？</td>
<td>select circle &lsquo;((0,5),1)&rsquo; &gt;^ circle  &lsquo;((0,0),1)&rsquo;;</td>
</tr>
<tr>
<td>?#</td>
<td>相交？</td>
<td>select lseg &lsquo;((-1,0),(1,0))&rsquo; ?# box  &lsquo;((-2,-2),(2,2))&rsquo;;</td>
</tr>
<tr>
<td>?-</td>
<td>水平？</td>
<td>select ?- lseg &lsquo;((-1,0),(1,0))&rsquo;;</td>
</tr>
<tr>
<td>?-</td>
<td>水平对齐？</td>
<td>select point &lsquo;(1,0)&rsquo; ?- point &lsquo;(0,0)&rsquo;;</td>
</tr>
<tr>
<td>?|</td>
<td>垂直？</td>
<td>select ?| lseg &lsquo;((-1,0),(1,0))&rsquo;;</td>
</tr>
<tr>
<td>?|</td>
<td>垂直对齐？</td>
<td>select point &lsquo;(0,1)&rsquo; ?| point &lsquo;(0,0)&rsquo;;</td>
</tr>
<tr>
<td>?-|</td>
<td>相互垂直？</td>
<td>select lseg &lsquo;((0,0),(0,1))&rsquo; ?-| lseg  &lsquo;((0,0),(1,0))&rsquo;;</td>
</tr>
<tr>
<td>?||</td>
<td>平行？</td>
<td>select lseg &lsquo;((-1,0),(1,0))&rsquo; ?|| lseg  &lsquo;((-1,2),(1,2))&rsquo;;</td>
</tr>
<tr>
<td>@&gt;</td>
<td>包含？</td>
<td>select circle &lsquo;((0,0),2)&rsquo; @&gt; point &lsquo;(1,1)&rsquo;;</td>
</tr>
<tr>
<td>&lt;@</td>
<td>包含在内或在上？</td>
<td>select point &lsquo;(1,1)&rsquo; &lt;@ circle &lsquo;((0,0),2)&rsquo;;</td>
</tr>
<tr>
<td>~=</td>
<td>相同？</td>
<td>select polygon &lsquo;((0,0),(1,1))&rsquo; ~= polygon  &lsquo;((1,1),(0,0))&rsquo;;</td>
</tr>
</tbody>
</table>
</p>
<p><strong>表</strong> <strong>.</strong> <strong>几何函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
</tr>
</thead>
<tbody>
<tr>
<td>area(object)</td>
<td>double precision</td>
<td>面积</td>
<td>select area(circle&rsquo;((0,0),1)&rsquo;) ;</td>
</tr>
<tr>
<td>center(object)</td>
<td>point</td>
<td>中心</td>
<td>select center(box &lsquo;((0,0),(1,2))&rsquo;) ;</td>
</tr>
<tr>
<td>diameter(circle)</td>
<td>double precision</td>
<td>圆的直径</td>
<td>select diameter(circle &lsquo;((0,0),2.0)&rsquo;) ;</td>
</tr>
<tr>
<td>height(box)</td>
<td>double precision</td>
<td>方框的垂直尺寸</td>
<td>select height(box &lsquo;((0,0),(1,1))&rsquo;) ;</td>
</tr>
<tr>
<td>isclosed(path)</td>
<td>boolean</td>
<td>一个封闭路径？</td>
<td>select isclosed(path &lsquo;((0,0),(1,1),(2,0))&rsquo;)  ;</td>
</tr>
<tr>
<td>isopen(path)</td>
<td>boolean</td>
<td>一个开放路径？</td>
<td>select isopen(path &lsquo;[(0,0),(1,1),(2,0)]&rsquo;)  ;</td>
</tr>
<tr>
<td>length(object)</td>
<td>double precision</td>
<td>长度</td>
<td>select length(path &lsquo;((-1,0),(1,0))&rsquo;) ;</td>
</tr>
<tr>
<td>npoints(path)</td>
<td>int</td>
<td>点数</td>
<td>select npoints(path &lsquo;[(0,0),(1,1),(2,0)]&rsquo;)  ;</td>
</tr>
<tr>
<td>npoints(polygon)</td>
<td>int</td>
<td>点数</td>
<td>select npoints(polygon &lsquo;((1,1),(0,0))&rsquo;) ;</td>
</tr>
<tr>
<td>pclose(path)</td>
<td>path</td>
<td>将路径转换成封闭的</td>
<td>select pclose(path &lsquo;[(0,0),(1,1),(2,0)]&rsquo;)  ;</td>
</tr>
<tr>
<td>popen(path)</td>
<td>path</td>
<td>将路径转换成开放</td>
<td>select popen(path &lsquo;((0,0),(1,1),(2,0))&rsquo;) ;</td>
</tr>
<tr>
<td>radius(circle)</td>
<td>double precision</td>
<td>圆的半径</td>
<td>select radius(circle &lsquo;((0,0),2.0)&rsquo;) ;</td>
</tr>
<tr>
<td>width(box)</td>
<td>double precision</td>
<td>方框的水平尺寸</td>
<td>select width(box &lsquo;((0,0),(1,1))&rsquo;) ;</td>
</tr>
</tbody>
</table>
</p>
<p><strong>表</strong> <strong>.</strong> <strong>几何类型转换函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
</tr>
</thead>
<tbody>
<tr>
<td>box(circle)</td>
<td>box</td>
<td>圆到方框</td>
<td>select box(circle &lsquo;((0,0),2.0)&rsquo;);</td>
</tr>
<tr>
<td>box(point)</td>
<td>box</td>
<td>点到空方框</td>
<td>select box(point &lsquo;(0,0)&rsquo;) ;</td>
</tr>
<tr>
<td>box(point, point)</td>
<td>box</td>
<td>点到方框</td>
<td>select box(point &lsquo;(0,0)&rsquo;, point &lsquo;(1,1)&rsquo;) ;</td>
</tr>
<tr>
<td>box(polygon)</td>
<td>box</td>
<td>多边形到方框</td>
<td>select box(polygon &lsquo;((0,0),(1,1),(2,0))&rsquo;) ;</td>
</tr>
<tr>
<td>bound_box(box, box)</td>
<td>box</td>
<td>方框到外包框</td>
<td>select bound_box(box &lsquo;((0,0),(1,1))&rsquo;, box  &lsquo;((3,3),(4,4))&rsquo;) ;</td>
</tr>
<tr>
<td>circle(box)</td>
<td>circle</td>
<td>方框到圆</td>
<td>select circle(box &lsquo;((0,0),(1,1))&rsquo;) ;</td>
</tr>
<tr>
<td>circle(point, double precision)</td>
<td>circle</td>
<td>中心和半径到圆</td>
<td>select circle(point &lsquo;(0,0)&rsquo;, 2.0) ;</td>
</tr>
<tr>
<td>circle(polygon)</td>
<td>circle</td>
<td>多边形到圆</td>
<td>select circle(polygon &lsquo;((0,0),(1,1),(2,0))&rsquo;)  ;</td>
</tr>
<tr>
<td>line(point, point)</td>
<td>line</td>
<td>点到线</td>
<td>select line(point &lsquo;(-1,0)&rsquo;, point &lsquo;(1,0)&rsquo;) ;</td>
</tr>
<tr>
<td>lseg(box)</td>
<td>lseg</td>
<td>方框对角线到线段</td>
<td>select lseg(box &lsquo;((-1,0),(1,0))&rsquo;) ;</td>
</tr>
<tr>
<td>lseg(point, point)</td>
<td>lseg</td>
<td>点到线段</td>
<td>select lseg(point &lsquo;(-1,0)&rsquo;, point &lsquo;(1,0)&rsquo;) ;</td>
</tr>
<tr>
<td>path(polygon)</td>
<td>path</td>
<td>多边形到路径</td>
<td>select path(polygon &lsquo;((0,0),(1,1),(2,0))&rsquo;) ;</td>
</tr>
<tr>
<td>point(double precision, double  precision)</td>
<td>point</td>
<td>构造点</td>
<td>select point(23.4, -44.5) ;</td>
</tr>
<tr>
<td>point(box)</td>
<td>point</td>
<td>方框的中心</td>
<td>select point(box &lsquo;((-1,0),(1,0))&rsquo;) ;</td>
</tr>
<tr>
<td>point(circle)</td>
<td>point</td>
<td>圆的中心</td>
<td>select point(circle &lsquo;((0,0),2.0)&rsquo;) ;</td>
</tr>
<tr>
<td>point(lseg)</td>
<td>point</td>
<td>线段的中心</td>
<td>select point(lseg &lsquo;((-1,0),(1,0))&rsquo;) ;</td>
</tr>
<tr>
<td>point(polygon)</td>
<td>point</td>
<td>多边形的中心</td>
<td>select point(polygon &lsquo;((0,0),(1,1),(2,0))&rsquo;) ;</td>
</tr>
<tr>
<td>polygon(box)</td>
<td>polygon</td>
<td>方框到4点多边形</td>
<td>select polygon(box &lsquo;((0,0),(1,1))&rsquo;) ;</td>
</tr>
<tr>
<td>polygon(circle)</td>
<td>polygon</td>
<td>圆到12点多边形</td>
<td>select polygon(circle &lsquo;((0,0),2.0)&rsquo;) ;</td>
</tr>
<tr>
<td>polygon(npts, circle)</td>
<td>polygon</td>
<td>点到npts点多边形</td>
<td>select polygon(12, circle &lsquo;((0,0),2.0)&rsquo;) ;</td>
</tr>
<tr>
<td>polygon(path)</td>
<td>polygon</td>
<td>路径到多边形</td>
<td>select polygon(path &lsquo;((0,0),(1,1),(2,0))&rsquo;) ;</td>
</tr>
</tbody>
</table>
</p>
<p>我们可以把一个point的两个组成数字当作具有索引 0 和 1 的数组访问。例如，如果t.p是一个point列，那么SELECT p[0] FROM t检索 X 座标而 UPDATE t SET p[1] = &hellip;改变 Y 座标。同样，box或者lseg类型的值可以当作两个point值的数组值看待。</p>
<p>函数area可以用于类型box、circle和path。area函数操作path数据类型的时候， 只有在path的点没有交叉的情况下才可用。例如，path &lsquo;((0,0),(0,1),(2,1),(2,2),(1,2),(1,0),(0,0))&rsquo;::PATH是不行的， 而下面的视觉上相同的 path &lsquo;((0,0),(0,1),(1,1),(1,2),(2,2),(2,1),(1,1),(1,0),(0,0))&rsquo;::PATH就可以。 如果交叉和不交叉的path概念让你疑惑，那么把上面两个path都画在一张图纸上，你就明白了。</p>
<h2 id="网络地址函数和操作符">网络地址函数和操作符 <a href="#%e7%bd%91%e7%bb%9c%e5%9c%b0%e5%9d%80%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>展示了可以用于cidr和 inet类型的操作符。 操作符&laquo;、&laquo;=、 &raquo;、&raquo;=和 &amp;&amp;测试用于子网包含。它们只考虑两个地址的网络部分（忽略任何主机部分），然后判断其中一个网络部分是等于另外一个或者是另外一个的子网。</p>
<p><strong>表.cidr和inet操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>操作符</th>
<th>描述</th>
<th>例子</th>
</tr>
</thead>
<tbody>
<tr>
<td>&lt;</td>
<td>小于</td>
<td>select inet  &lsquo;192.168.1.5&rsquo; &lt; inet &lsquo;192.168.1.6&rsquo; ;</td>
</tr>
<tr>
<td>&lt;=</td>
<td>小于等于</td>
<td>select inet  &lsquo;192.168.1.5&rsquo; &lt;= inet &lsquo;192.168.1.5&rsquo; ;</td>
</tr>
<tr>
<td>=</td>
<td>等于</td>
<td>select inet  &lsquo;192.168.1.5&rsquo; = inet &lsquo;192.168.1.5&rsquo; ;</td>
</tr>
<tr>
<td>&gt;=</td>
<td>大于等于</td>
<td>select inet &lsquo;192.168.1.5&rsquo;  &gt;= inet &lsquo;192.168.1.5&rsquo; ;</td>
</tr>
<tr>
<td>&gt;</td>
<td>大于</td>
<td>select inet  &lsquo;192.168.1.5&rsquo; &gt; inet &lsquo;192.168.1.4&rsquo; ;</td>
</tr>
<tr>
<td>&lt;&gt;</td>
<td>不等于</td>
<td>select inet  &lsquo;192.168.1.5&rsquo; &lt;&gt; inet &lsquo;192.168.1.4&rsquo; ;</td>
</tr>
<tr>
<td>&laquo;</td>
<td>被包含在内</td>
<td>select inet  &lsquo;192.168.1.5&rsquo; &laquo; inet &lsquo;192.168.1/24&rsquo; ;</td>
</tr>
<tr>
<td>&laquo;=</td>
<td>被包含在内或等于</td>
<td>select inet &lsquo;192.168.1/24&rsquo;  &laquo;= inet &lsquo;192.168.1/24&rsquo; ;</td>
</tr>
<tr>
<td>&raquo;</td>
<td>包含</td>
<td>select inet  &lsquo;192.168.1/24&rsquo; &raquo; inet &lsquo;192.168.1.5&rsquo; ;</td>
</tr>
<tr>
<td>&raquo;=</td>
<td>包含或等于</td>
<td>select inet  &lsquo;192.168.1/24&rsquo; &raquo;= inet &lsquo;192.168.1/24&rsquo; ;</td>
</tr>
<tr>
<td>&amp;&amp;</td>
<td>包含或者被包含contains or is contained by</td>
<td>select inet  &lsquo;192.168.1/24&rsquo; &amp;&amp; inet &lsquo;192.168.1.80/28&rsquo; ;</td>
</tr>
<tr>
<td>~</td>
<td>按位 NOT</td>
<td>select ~ inet  &lsquo;192.168.1.6&rsquo; ;</td>
</tr>
<tr>
<td>&amp;</td>
<td>按位 AND</td>
<td>select inet  &lsquo;192.168.1.6&rsquo; &amp; inet &lsquo;0.0.0.255&rsquo; ;</td>
</tr>
<tr>
<td>|</td>
<td>按位 OR</td>
<td>select inet  &lsquo;192.168.1.6&rsquo; | inet &lsquo;0.0.0.255&rsquo; ;</td>
</tr>
<tr>
<td>+</td>
<td>加</td>
<td>select inet  &lsquo;192.168.1.6&rsquo; + 25 ;</td>
</tr>
<tr>
<td>-</td>
<td>减</td>
<td>select inet  &lsquo;192.168.1.43&rsquo; - 36 ;</td>
</tr>
<tr>
<td>-</td>
<td>减</td>
<td>select inet &lsquo;192.168.1.43&rsquo;  - inet &lsquo;192.168.1.19&rsquo; ;</td>
</tr>
</tbody>
</table>
</p>
<p>展示了所有可以用于cidr和inet类型的函数。函数abbrev、host和text主要是为了提供可选的显示格式用的。</p>
<p><strong>表</strong> <strong>. cidr和inet函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>abbrev(inet)</td>
<td>text</td>
<td>缩写显示格式文本</td>
<td>select abbrev(inet &lsquo;10.1.0.0/16&rsquo;);</td>
<td>10.1.0.0/16</td>
</tr>
<tr>
<td>abbrev(cidr)</td>
<td>text</td>
<td>缩写显示格式文本</td>
<td>select abbrev(cidr &lsquo;10.1.0.0/16&rsquo;) ;</td>
<td>10.1/16</td>
</tr>
<tr>
<td>broadcast(inet)</td>
<td>inet</td>
<td>网络广播地址</td>
<td>select broadcast(&lsquo;192.168.1.5/24&rsquo;) ;</td>
<td>192.168.1.255/24</td>
</tr>
<tr>
<td>family(inet)</td>
<td>int</td>
<td>抽取地址族；4为 IPv4， 6为 IPv6</td>
<td>select family(&rsquo;::1&rsquo;) ;</td>
<td>6</td>
</tr>
<tr>
<td>host(inet)</td>
<td>text</td>
<td>抽取 IP 地址为文本</td>
<td>select host(&lsquo;192.168.1.5/24&rsquo;) ;</td>
<td>192.168.1.5</td>
</tr>
<tr>
<td>hostmask(inet)</td>
<td>inet</td>
<td>为网络构造主机掩码</td>
<td>select hostmask(&lsquo;192.168.23.20/30&rsquo;) ;</td>
<td>0.0.0.3</td>
</tr>
<tr>
<td>masklen(inet)</td>
<td>int</td>
<td>抽取网络掩码长度</td>
<td>select masklen(&lsquo;192.168.1.5/24&rsquo;) ;</td>
<td>24</td>
</tr>
<tr>
<td>netmask(inet)</td>
<td>inet</td>
<td>为网络构造网络掩码</td>
<td>select netmask(&lsquo;192.168.1.5/24&rsquo;) ;</td>
<td>255.255.255.0</td>
</tr>
<tr>
<td>network(inet)</td>
<td>cidr</td>
<td>抽取地址的网络部分</td>
<td>select network(&lsquo;192.168.1.5/24&rsquo;) ;</td>
<td>192.168.1.0/24</td>
</tr>
<tr>
<td>set_masklen(inet, int)</td>
<td>inet</td>
<td>为inet值设置网络掩码长度</td>
<td>select set_masklen(&lsquo;192.168.1.5/24&rsquo;, 16) ;</td>
<td>192.168.1.5/16</td>
</tr>
<tr>
<td>set_masklen(cidr, int)</td>
<td>cidr</td>
<td>为cidr值设置网络掩码长度</td>
<td>select set_masklen(&lsquo;192.168.1.0/24&rsquo;::cidr, 16) ;</td>
<td>192.168.0.0/16</td>
</tr>
<tr>
<td>text(inet)</td>
<td>text</td>
<td>抽取 IP 地址和网络掩码长度为文本</td>
<td>select text(inet &lsquo;192.168.1.5&rsquo;) ;</td>
<td>192.168.1.5/32</td>
</tr>
<tr>
<td>inet_same_family(inet, inet)</td>
<td>boolean</td>
<td>地址是来自于同一个家族吗？</td>
<td>select inet_same_family(&lsquo;192.168.1.5/24&rsquo;, &lsquo;::1&rsquo;) ;</td>
<td>false</td>
</tr>
<tr>
<td>inet_merge(inet, inet)</td>
<td>cidr</td>
<td>包括给定网络的最小网络</td>
<td>select inet_merge(&lsquo;192.168.1.5/24&rsquo;, &lsquo;192.168.2.5/24&rsquo;) ;</td>
<td>192.168.0.0/22</td>
</tr>
</tbody>
</table>
</p>
<p>任何cidr值都能够被隐式或显式地转换为inet值， 因此上述能够操作inet值的函数也同样能够操作cidr值（也有独立的用于inet和cidr的函数，因为它的行为应当和这两种情况不同）。inet值也可以转换为cidr值。完成时，该网络掩码右侧的任何位都将无声地转换为零以获得一个有效的cidr值。另外，你还可以使用常规的造型语法将一个文本字符串转换为inet或cidr值：例如，inet(expression)或colname::cidr。</p>
<p>下表展示了可以用于macaddr类型的函数。 函数trunc(macaddr)返回一个 MAC 地址，该地址的最后三个字节设置为零。这样可以把剩下的前缀与一个制造商相关联。</p>
<p><strong>表. macaddr函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>trunc(macaddr)</td>
<td>macaddr</td>
<td>设置最后3个字节为零</td>
<td><code>select trunc(macaddr  '12:34:56:78:90:ab');</code></td>
<td><code> 12:34:56:00:00:00</code></td>
</tr>
</tbody>
</table>
</p>
<p>macaddr类型还支持标准关系操作符 （&gt;、&lt;=等） 用于编辑次序，并且按位算术操作符（~、&amp;和|）用于 NOT、AND 和 OR。</p>
<p>表 中展示了可以用于macaddr8类型的函数。函数trunc(macaddr8)返回一个后五个字节设置为零的MAC地址。这可以被用来为一个制造商关联一个前缀。</p>
<p><strong>表. macaddr8函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>trunc(macaddr8)</td>
<td>macaddr8</td>
<td>设置最后五个字节为零</td>
<td><code>select trunc(macaddr8 '12:34:56:78:90:ab:cd:ef');</code></td>
<td><code>12:34:56:00:00:00:00:00</code></td>
</tr>
<tr>
<td>macaddr8_set7bit(macaddr8)</td>
<td>macaddr8</td>
<td>设置第7位为一，也被称为修改版的EUI-64，用于内含在IPv6地址中</td>
<td><code>select macaddr8_set7bit(macaddr8 '00:34:56:ab:cd:ef'); </code></td>
<td><code>02:34:56:ff:fe:ab:cd:ef</code></td>
</tr>
</tbody>
</table>
</p>
<p>macaddr8类型也支持用于排序的标准关系操作符（&gt;、&lt;=等）以及用于NOT、AND和OR的位运算操作符（~、&amp;和|）。</p>
<h2 id="文本搜索函数和操作符">文本搜索函数和操作符 <a href="#%e6%96%87%e6%9c%ac%e6%90%9c%e7%b4%a2%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>结了为全文搜索提供的函数和操作符。</p>
<p><strong>表.文本搜索操作符</strong></p>







<table class="table table-striped">
<thead>
<tr>
<th>操作符</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>||</td>
<td>tsvector</td>
<td>连接tsvector</td>
<td>&lsquo;a:1 b:2&rsquo;::tsvector  || &lsquo;c:1 d:2 b:3&rsquo;::tsvector</td>
<td>&lsquo;a&rsquo;:1 &lsquo;b&rsquo;:2,5 &lsquo;c&rsquo;:3 &rsquo;d&rsquo;:4</td>
</tr>
<tr>
<td>&amp;&amp;</td>
<td>tsquery</td>
<td>将tsquery用 AND 连接起来</td>
<td>&lsquo;fat | rat&rsquo;::tsquery  &amp;&amp; &lsquo;cat&rsquo;::tsquery</td>
<td>( &lsquo;fat&rsquo; | &lsquo;rat&rsquo; )  &amp; &lsquo;cat&rsquo;</td>
</tr>
<tr>
<td>||</td>
<td>tsquery</td>
<td>将tsquery用 OR 连接起来</td>
<td>&lsquo;fat | rat&rsquo;::tsquery  || &lsquo;cat&rsquo;::tsquery</td>
<td>( &lsquo;fat&rsquo; | &lsquo;rat&rsquo; ) |  &lsquo;cat&rsquo;</td>
</tr>
<tr>
<td>!!</td>
<td>tsquery</td>
<td>对一个tsquery取反</td>
<td>!! &lsquo;cat&rsquo;::tsquery</td>
<td>!&lsquo;cat&rsquo;</td>
</tr>
<tr>
<td>@&gt;</td>
<td>boolean</td>
<td>tsquery包含另一个？</td>
<td>&lsquo;cat&rsquo;::tsquery @&gt;  &lsquo;cat &amp; rat&rsquo;::tsquery</td>
<td>f</td>
</tr>
<tr>
<td>&lt;@</td>
<td>boolean</td>
<td>tsquery被包含？</td>
<td>&lsquo;cat&rsquo;::tsquery &lt;@  &lsquo;cat &amp; rat&rsquo;::tsquery</td>
<td>t</td>
</tr>
</tbody>
</table>

<p>除了显示在表中的操作符，还定义了tsvector和tsquery类型的普通B-tree比较操作符（=、&lt;等）。它们对于文本搜索不是很有用，但是允许使用。例如，建在这些类型列上的唯一索引。</p>
<p><strong>表.文本搜索函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>array_to_tsvector(text[])</td>
<td>tsvector</td>
<td>把词位数组转换成tsvector</td>
<td>array_to_tsvector(&rsquo;{fat,cat,rat}&rsquo;::text[])</td>
<td>&lsquo;cat&rsquo; &lsquo;fat&rsquo; &lsquo;rat&rsquo;</td>
</tr>
<tr>
<td>length(tsvector)</td>
<td>integer</td>
<td>tsvector中的词位数</td>
<td>length(&lsquo;fat:2,4 cat:3 rat:5A&rsquo;::tsvector)</td>
<td>3</td>
</tr>
<tr>
<td>numnode(tsquery)</td>
<td>integer</td>
<td>tsquery中词位外加操作符的数目</td>
<td>numnode(&rsquo;(fat &amp; rat) | cat&rsquo;::tsquery)</td>
<td>5</td>
</tr>
<tr>
<td>querytree(query tsquery)</td>
<td>text</td>
<td>获得一个tsquery的可索引部分</td>
<td>querytree(&lsquo;foo &amp; ! bar&rsquo;::tsquery)</td>
<td>&lsquo;foo&rsquo;</td>
</tr>
<tr>
<td>setweight(vector tsvector, weight &ldquo;char&rdquo;)</td>
<td>tsvector</td>
<td>为vector的每一个元素分配权重</td>
<td>setweight(&lsquo;fat:2,4 cat:3 rat:5B&rsquo;::tsvector, &lsquo;A&rsquo;)</td>
<td>&lsquo;cat&rsquo;:3A &lsquo;fat&rsquo;:2A,4A &lsquo;rat&rsquo;:5A</td>
</tr>
<tr>
<td>setweight(vector tsvector, weight &ldquo;char&rdquo;, lexemes text[])</td>
<td>tsvector</td>
<td>为lexemes中列出的vector的元素分配权重</td>
<td>setweight(&lsquo;fat:2,4 cat:3 rat:5B&rsquo;::tsvector, &lsquo;A&rsquo;, &lsquo;{cat,rat}&rsquo;)</td>
<td>&lsquo;cat&rsquo;:3A &lsquo;fat&rsquo;:2,4 &lsquo;rat&rsquo;:5A</td>
</tr>
<tr>
<td>strip(tsvector)</td>
<td>tsvector</td>
<td>从tsvector中移除位置和权重</td>
<td>strip(&lsquo;fat:2,4 cat:3 rat:5A&rsquo;::tsvector)</td>
<td>&lsquo;cat&rsquo; &lsquo;fat&rsquo; &lsquo;rat&rsquo;</td>
</tr>
<tr>
<td>ts_delete(vector tsvector, lexeme text)</td>
<td>tsvector</td>
<td>从vector中移除给定的lexeme</td>
<td>ts_delete(&lsquo;fat:2,4 cat:3 rat:5A&rsquo;::tsvector, &lsquo;fat&rsquo;)</td>
<td>&lsquo;cat&rsquo;:3 &lsquo;rat&rsquo;:5A</td>
</tr>
<tr>
<td>ts_delete(vector tsvector, lexemes text[])</td>
<td>tsvector</td>
<td>从vector中移除lexemes中词位的任何出现</td>
<td>ts_delete(&lsquo;fat:2,4 cat:3 rat:5A&rsquo;::tsvector, ARRAY[&lsquo;fat&rsquo;,&lsquo;rat&rsquo;])</td>
<td>&lsquo;cat&rsquo;:3</td>
</tr>
<tr>
<td>ts_filter(vector tsvector, weights &ldquo;char&rdquo;[])</td>
<td>tsvector</td>
<td>从vector中只选择带有给定权重的元素</td>
<td>ts_filter(&lsquo;fat:2,4 cat:3b rat:5A&rsquo;::tsvector, &lsquo;{a,b}&rsquo;)</td>
<td>&lsquo;cat&rsquo;:3B &lsquo;rat&rsquo;:5A</td>
</tr>
<tr>
<td>ts_rewrite(query tsquery, target tsquery, substitute tsquery)</td>
<td>tsquery</td>
<td>在查询内用substitute替换target</td>
<td>ts_rewrite(&lsquo;a &amp; b&rsquo;::tsquery, &lsquo;a&rsquo;::tsquery, &lsquo;foo|bar&rsquo;::tsquery)</td>
<td>&lsquo;b&rsquo; &amp; ( &lsquo;foo&rsquo; | &lsquo;bar&rsquo; )</td>
</tr>
<tr>
<td>tsvector_to_array(tsvector)</td>
<td>text[]</td>
<td>把tsvector转换为词位数组</td>
<td>tsvector_to_array(&lsquo;fat:2,4 cat:3 rat:5A&rsquo;::tsvector)</td>
<td>{cat,fat,rat}</td>
</tr>
<tr>
<td>unnest(tsvector, OUT lexeme text,  OUT positions smallint[], OUT weights text)</td>
<td>setof record</td>
<td>把一个 tsvector 扩展成一组行</td>
<td>unnest(&lsquo;fat:2,4 cat:3 rat:5A&rsquo;::tsvector)</td>
<td>(cat,{3},{D}) &hellip;</td>
</tr>
</tbody>
</table>
</p>
<p>表中的函数被单独列出，因为它们通常不被用于日常的文本搜索操作。 它们有助于开发和调试新的文本搜索配置。</p>
<p><strong>表.文本搜索调试函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>ts_parse(parser_name text, document text,  OUT tokid integer, OUT token text)</td>
<td>setof record</td>
<td>测试一个解析器</td>
<td>ts_parse(&lsquo;default&rsquo;, &lsquo;foo - bar&rsquo;)</td>
<td>(1,foo) &hellip;</td>
</tr>
<tr>
<td>ts_parse(parser_oid oid, document text,  OUT tokid integer, OUT token text)</td>
<td>setof record</td>
<td>测试一个解析器</td>
<td>ts_parse(3722, &lsquo;foo - bar&rsquo;)</td>
<td>(1,foo) &hellip;</td>
</tr>
<tr>
<td>ts_token_type(parser_name text, OUT tokid integer,  OUT alias text, OUT description text)</td>
<td>setof record</td>
<td>获得解析器定义的记号类型</td>
<td>ts_token_type(&lsquo;default&rsquo;)</td>
<td>(1,asciiword,&ldquo;Word, all ASCII&rdquo;) &hellip;</td>
</tr>
<tr>
<td>ts_token_type(parser_oid oid, OUT tokid integer,  OUT alias text, OUT description text)</td>
<td>setof record</td>
<td>获得解析器定义的记号类型</td>
<td>ts_token_type(3722)</td>
<td>(1,asciiword,&ldquo;Word, all ASCII&rdquo;) &hellip;</td>
</tr>
</tbody>
</table>
</p>
<h2 id="json函数与操作符">JSON函数与操作符 <a href="#json%e5%87%bd%e6%95%b0%e4%b8%8e%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>大多数运算符都是重载的，因此可以同时在json和jsonb值上使用它们。下表展示了可以用于两种 JSON 数据类型的操作符。</p>
<p><strong>表</strong> json<strong>和</strong>jsonb <strong>操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>操作符</strong></th>
<th><strong>右操作数类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>例子结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>-&gt;</td>
<td>int</td>
<td>获得 JSON 数组元素（索引从 0 开始，负整数从末尾开始计）</td>
<td>&lsquo;[{&ldquo;a&rdquo;:&ldquo;foo&rdquo;},{&ldquo;b&rdquo;:&ldquo;bar&rdquo;},{&ldquo;c&rdquo;:&ldquo;baz&rdquo;}]&rsquo;::json-&gt;2</td>
<td>{&ldquo;c&rdquo;:&ldquo;baz&rdquo;}</td>
</tr>
<tr>
<td>-&gt;</td>
<td>text</td>
<td>通过键获得 JSON 对象域</td>
<td>&lsquo;{&ldquo;a&rdquo;: {&ldquo;b&rdquo;:&ldquo;foo&rdquo;}}&rsquo;::json-&gt;&lsquo;a&rsquo;</td>
<td>{&ldquo;b&rdquo;:&ldquo;foo&rdquo;}</td>
</tr>
<tr>
<td>-&raquo;</td>
<td>int</td>
<td>以text形式获得 JSON 数组元素</td>
<td>&lsquo;[1,2,3]&rsquo;::json-&raquo;2</td>
<td>3</td>
</tr>
<tr>
<td>-&raquo;</td>
<td>text</td>
<td>以text形式获得 JSON 对象域</td>
<td>&lsquo;{&ldquo;a&rdquo;:1,&ldquo;b&rdquo;:2}&rsquo;::json-&raquo;&lsquo;b&rsquo;</td>
<td>2</td>
</tr>
<tr>
<td>#&gt;</td>
<td>text[]</td>
<td>获取在指定路径的 JSON 对象</td>
<td>&lsquo;{&ldquo;a&rdquo;: {&ldquo;b&rdquo;:{&ldquo;c&rdquo;:  &ldquo;foo&rdquo;}}}&rsquo;::json#&gt;&rsquo;{a,b}&rsquo;</td>
<td>{&ldquo;c&rdquo;: &ldquo;foo&rdquo;}</td>
</tr>
<tr>
<td>#&raquo;</td>
<td>text[]</td>
<td>以text形式获取在指定路径的 JSON 对象</td>
<td>&lsquo;{&ldquo;a&rdquo;:[1,2,3],&ldquo;b&rdquo;:[4,5,6]}&rsquo;::json#&raquo;&rsquo;{a,2}&rsquo;</td>
<td>3</td>
</tr>
</tbody>
</table>
</p>
<p>注意：对json和jsonb类型，这些操作符都有其并行变体。 域/元素/路径抽取操作符返回与其左手输入（json或jsonb） 相同的类型，不过那些被指定为返回text的除外，它们的返回值会被强制 为文本。如果该 JSON 输入没有匹配请求的正确结构（例如那样的元素不存在），这些 域/元素/路径抽取操作符会返回 NULL 而不是失败。 接受整数 JSON 数组下标的 域/元素/路径抽取操作符都支持表示从数组末尾开始的负值下标形式。</p>
<p><strong>表</strong> <strong>额外的jsonb操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>操作符</strong></th>
<th><strong>右操作数类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>@&gt;</td>
<td>jsonb</td>
<td>左边的 JSON 值是否在顶层包含右边的 JSON 路径/值项？</td>
<td>&lsquo;{&ldquo;a&rdquo;:1, &ldquo;b&rdquo;:2}&rsquo;::jsonb @&gt;  &lsquo;{&ldquo;b&rdquo;:2}&rsquo;::jsonb</td>
</tr>
<tr>
<td>&lt;@</td>
<td>jsonb</td>
<td>左边的 JSON 路径/值项是否被包含在右边的 JSON 值的顶层？</td>
<td>&lsquo;{&ldquo;b&rdquo;:2}&rsquo;::jsonb &lt;@ &lsquo;{&ldquo;a&rdquo;:1,  &ldquo;b&rdquo;:2}&rsquo;::jsonb</td>
</tr>
<tr>
<td>?</td>
<td>text</td>
<td>键/元素字符串是否存在于 JSON 值的顶层？</td>
<td>&lsquo;{&ldquo;a&rdquo;:1, &ldquo;b&rdquo;:2}&rsquo;::jsonb ? &lsquo;b&rsquo;</td>
</tr>
<tr>
<td>?|</td>
<td>text[]</td>
<td>这些数组字符串中的任何一个是否做为顶层键存在？</td>
<td>&lsquo;{&ldquo;a&rdquo;:1, &ldquo;b&rdquo;:2, &ldquo;c&rdquo;:3}&rsquo;::jsonb ?|  array[&lsquo;b&rsquo;, &lsquo;c&rsquo;]</td>
</tr>
<tr>
<td>?&amp;</td>
<td>text[]</td>
<td>是否所有这些数组字符串都作为顶层键存在？</td>
<td>&lsquo;[&ldquo;a&rdquo;, &ldquo;b&rdquo;]&rsquo;::jsonb ?&amp; array[&lsquo;a&rsquo;, &lsquo;b&rsquo;]</td>
</tr>
<tr>
<td>||</td>
<td>jsonb</td>
<td>把两个jsonb值串接成一个新的jsonb值</td>
<td>&lsquo;[&ldquo;a&rdquo;, &ldquo;b&rdquo;]&rsquo;::jsonb || &lsquo;[&ldquo;c&rdquo;,  &ldquo;d&rdquo;]&rsquo;::jsonb</td>
</tr>
<tr>
<td>-</td>
<td>text</td>
<td>从左操作数删除键/值对或者string 元素。键/值对基于它们的键值来匹配。</td>
<td>&lsquo;{&ldquo;a&rdquo;: &ldquo;b&rdquo;}&rsquo;::jsonb - &lsquo;a&rsquo;</td>
</tr>
<tr>
<td>-</td>
<td>text[]</td>
<td>从左操作数中删除多个键/值对或者string元素。键/值对基于它们的键值来匹配。</td>
<td>&lsquo;{&ldquo;a&rdquo;: &ldquo;b&rdquo;, &ldquo;c&rdquo;: &ldquo;d&rdquo;}&rsquo;::jsonb -  &lsquo;{a,c}&rsquo;::text[]</td>
</tr>
<tr>
<td>-</td>
<td>integer</td>
<td>删除具有指定索引（负值表示倒数）的数组元素。如果 顶层容器不是数组则抛出一个错误。</td>
<td>&lsquo;[&ldquo;a&rdquo;, &ldquo;b&rdquo;]&rsquo;::jsonb - 1</td>
</tr>
<tr>
<td>#-</td>
<td>text[]</td>
<td>删除具有指定路径的域或者元素（对于 JSON 数组，负值 表示倒数）</td>
<td>&lsquo;[&ldquo;a&rdquo;, {&ldquo;b&rdquo;:1}]&rsquo;::jsonb #- &lsquo;{1,b}&rsquo;</td>
</tr>
</tbody>
</table>
</p>
<p>注意：||操作符将其每一个操作数的顶层的元素串接起来。它不会递归操作。例如，如果两个操作数都是具有公共域名称的对象，结果中的域值将只是来自右手操作数的值。</p>
<p>下表展示了可用于创建 json 和 jsonb值的函数（没有用于 jsonb的与row_to_json和 array_to_json等价的函数。不过，to_jsonb函数 提供了这些函数的很大一部分相同的功能）。</p>
<p><strong>表. JSON创建函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>例子结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>to_json(anyelement)  to_jsonb(anyelement)</td>
<td>把该值返回为json或者jsonb。数组和组合 会被（递归）转换成数组和对象；对于不是数组和组合的值，如果有 从该类型到json的造型，造型函数将被用来执行该 转换；否则将产生一个标量值。对于任何不是数字、布尔、空值的标 量类型，将使用文本表达，在这种风格下它是一个合法的 json或者jsonb值。</td>
<td>to_json(&lsquo;Fred said &ldquo;Hi.&rdquo;&rsquo;::text)</td>
<td>&ldquo;Fred said &quot;Hi.&quot;&rdquo;</td>
</tr>
<tr>
<td>row_to_json(record [, pretty_bool])</td>
<td>把行作为一个 JSON 对象返回。如果pretty_bool为真，将在第1层元素之间增加换行。</td>
<td>row_to_json(row(1,&lsquo;foo&rsquo;))</td>
<td>{&ldquo;f1&rdquo;:1,&ldquo;f2&rdquo;:&ldquo;foo&rdquo;}</td>
</tr>
<tr>
<td>json_build_array(VARIADIC &ldquo;any&rdquo;)  jsonb_build_array(VARIADIC &ldquo;any&rdquo;)</td>
<td>从一个可变参数列表构造一个可能包含异质类型的 JSON 数组。</td>
<td>json_build_array(1,2,&lsquo;3&rsquo;,4,5)</td>
<td>[1, 2, &ldquo;3&rdquo;, 4, 5]</td>
</tr>
<tr>
<td>json_build_object(VARIADIC &ldquo;any&rdquo;)  jsonb_build_object(VARIADIC &ldquo;any&rdquo;)</td>
<td>从一个可变参数列表构造一个 JSON 对象。通过转换，该参数列表由交替 出现的键和值构成。</td>
<td>json_build_object(&lsquo;foo&rsquo;,1,&lsquo;bar&rsquo;,2)</td>
<td>{&ldquo;foo&rdquo;: 1, &ldquo;bar&rdquo;: 2}</td>
</tr>
<tr>
<td>json_object(keys text[], values text[])  jsonb_object(keys text[], values text[])</td>
<td>json_object的这种形式从两个独立的数组得到键/值对。在其 他方面和一个参数的形式相同。</td>
<td>json_object(&rsquo;{a, b}&rsquo;, &lsquo;{1,2}&rsquo;)</td>
<td>{&ldquo;a&rdquo;: &ldquo;1&rdquo;, &ldquo;b&rdquo;: &ldquo;2&rdquo;}</td>
</tr>
</tbody>
</table>
</p>
<p>注意：array_to_json和row_to_json与to_json 具有相同的行为，不过它们提供了更好的打印选项。针对to_json所描述 的行为同样也适用于由其他 JSON 创建函数转换的每个值。</p>
<p>下表展示了可用来处理json 和jsonb值的函数。</p>
<p><strong>表. JSON处理</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>返回值</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>例子结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>json_array_length(json)  jsonb_array_length(jsonb)</td>
<td>int</td>
<td>返回最外层 JSON 数组中的元素数量。</td>
<td>json_array_length(&rsquo;[1,2,3,{&ldquo;f1&rdquo;:1,&ldquo;f2&rdquo;:[5,6]},4]')</td>
<td>5</td>
</tr>
<tr>
<td>json_each(json)  jsonb_each(jsonb)</td>
<td>setof key text, value json  setof key text, value jsonb</td>
<td>扩展最外层的 JSON 对象成为一组键/值对。</td>
<td>select * from json_each(&rsquo;{&ldquo;a&rdquo;:&ldquo;foo&rdquo;,  &ldquo;b&rdquo;:&ldquo;bar&rdquo;}')</td>
<td>key | value  &mdash;&ndash;+&mdash;&mdash;-   a  | &ldquo;foo&rdquo;   b  | &ldquo;bar&rdquo;</td>
</tr>
<tr>
<td>json_each_text(json)  jsonb_each_text(jsonb)</td>
<td>setof key text, value text</td>
<td>扩展最外层的 JSON 对象成为一组键/值对。返回值将是text类型。</td>
<td>select * from json_each_text(&rsquo;{&ldquo;a&rdquo;:&ldquo;foo&rdquo;,  &ldquo;b&rdquo;:&ldquo;bar&rdquo;}')</td>
<td>key | value  &mdash;&ndash;+&mdash;&mdash;-   a  | foo   b  |  bar</td>
</tr>
<tr>
<td>json_extract_path(from_json json, VARIADIC path_elems text[])  jsonb_extract_path(from_json jsonb, VARIADIC path_elems text[])</td>
<td>json  jsonb</td>
<td>返回由path_elems指向的 JSON 值（等效于#&gt;操作符）。</td>
<td>json_extract_path(&rsquo;{&ldquo;f2&rdquo;:{&ldquo;f3&rdquo;:1},&ldquo;f4&rdquo;:{&ldquo;f5&rdquo;:99,&ldquo;f6&rdquo;:&ldquo;foo&rdquo;}}&rsquo;,&lsquo;f4&rsquo;)</td>
<td>{&ldquo;f5&rdquo;:99,&ldquo;f6&rdquo;:&ldquo;foo&rdquo;}</td>
</tr>
<tr>
<td>json_extract_path_text(from_json json, VARIADIC path_elems text[])  jsonb_extract_path_text(from_json jsonb, VARIADIC path_elems text[])</td>
<td>text</td>
<td>以text返回由path_elems指向的 JSON 值（等效于#&raquo;操作符）。</td>
<td>json_extract_path_text(&rsquo;{&ldquo;f2&rdquo;:{&ldquo;f3&rdquo;:1},&ldquo;f4&rdquo;:{&ldquo;f5&rdquo;:99,&ldquo;f6&rdquo;:&ldquo;foo&rdquo;}}&rsquo;,&lsquo;f4&rsquo;,  &lsquo;f6&rsquo;)</td>
<td>foo</td>
</tr>
<tr>
<td>json_object_keys(json)  jsonb_object_keys(jsonb)</td>
<td>setof text</td>
<td>返回最外层 JSON 对象中的键集合。</td>
<td>json_object_keys(&rsquo;{&ldquo;f1&rdquo;:&ldquo;abc&rdquo;,&ldquo;f2&rdquo;:{&ldquo;f3&rdquo;:&ldquo;a&rdquo;,  &ldquo;f4&rdquo;:&ldquo;b&rdquo;}}&rsquo;)</td>
<td>json_object_keys  &mdash;&mdash;&mdash;&mdash;&mdash;&mdash;   f1   f2</td>
</tr>
<tr>
<td>json_populate_record(base anyelement, from_json json)  jsonb_populate_record(base anyelement, from_json jsonb)</td>
<td>anyelement</td>
<td>扩展from_json中的对象成一个行，它的列匹配由base定义的记录类型。</td>
<td>select * from json_populate_record(null::myrowtype, &lsquo;{&ldquo;a&rdquo;: 1, &ldquo;b&rdquo;:  [&ldquo;2&rdquo;, &ldquo;a b&rdquo;], &ldquo;c&rdquo;: {&ldquo;d&rdquo;: 4,  &ldquo;e&rdquo;: &ldquo;a b c&rdquo;}}&rsquo;)</td>
<td>a |  b     |   c  &mdash;+&mdash;&mdash;&mdash;&ndash;+&mdash;&mdash;&mdash;&mdash;-   1 | {2,&ldquo;a b&rdquo;} |  (4,&ldquo;a b c&rdquo;)</td>
</tr>
<tr>
<td>json_populate_recordset(base anyelement, from_json json)  jsonb_populate_recordset(base anyelement, from_json jsonb)</td>
<td>setof anyelement</td>
<td>扩展from_json中最外的对象数组为一个集合，该集合的列匹配由base定义的记录类型。</td>
<td>select * from json_populate_recordset(null::myrowtype,  &lsquo;[{&ldquo;a&rdquo;:1,&ldquo;b&rdquo;:2},{&ldquo;a&rdquo;:3,&ldquo;b&rdquo;:4}]&rsquo;)</td>
<td>a | b  &mdash;+&mdash;   1 | 2   3 | 4</td>
</tr>
<tr>
<td>json_array_elements(json)  jsonb_array_elements(jsonb)</td>
<td>setof json  setof jsonb</td>
<td>把一个 JSON 数组扩展成一个 JSON 值的集合。</td>
<td>select * from json_array_elements(&rsquo;[1,true, [2,false]]')</td>
<td>value  &mdash;&mdash;&mdash;&ndash;   1   true   [2,false]</td>
</tr>
<tr>
<td>json_array_elements_text(json)  jsonb_array_elements_text(jsonb)</td>
<td>setof text</td>
<td>把一个 JSON 数组扩展成一个text值集合。</td>
<td>select * from json_array_elements_text(&rsquo;[&ldquo;foo&rdquo;,  &ldquo;bar&rdquo;]')</td>
<td>value  &mdash;&mdash;&mdash;&ndash;   foo   bar</td>
</tr>
<tr>
<td>json_typeof(json)  jsonb_typeof(jsonb)</td>
<td>text</td>
<td>把最外层的 JSON 值的类型作为一个文本字符串返回。可能的类型是： object、array、string、number、 boolean以及null。</td>
<td>json_typeof(&rsquo;-123.4')</td>
<td>number</td>
</tr>
<tr>
<td>json_to_record(json)  jsonb_to_record(jsonb)</td>
<td>record</td>
<td>从一个 JSON 对象（见下文的注解）构建一个任意的记录。正如所有返回record 的函数一样，调用者必须用一个AS子句显式地定义记录的结构。</td>
<td>select * from  json_to_record(&rsquo;{&ldquo;a&rdquo;:1,&ldquo;b&rdquo;:[1,2,3],&ldquo;c&rdquo;:[1,2,3],&ldquo;e&rdquo;:&ldquo;bar&rdquo;,&ldquo;r&rdquo;:  {&ldquo;a&rdquo;: 123, &ldquo;b&rdquo;: &ldquo;a b c&rdquo;}}&rsquo;) as x(a int, b text,  c int[], d text, r myrowtype)</td>
<td>a |  b    |  c  | d |     r  &mdash;+&mdash;&mdash;&mdash;+&mdash;&mdash;&mdash;+&mdash;+&mdash;&mdash;&mdash;&mdash;&mdash;   1 | [1,2,3] | {1,2,3} |  | (123,&ldquo;a b c&rdquo;)</td>
</tr>
<tr>
<td>json_to_recordset(json)  jsonb_to_recordset(jsonb)</td>
<td>setof record</td>
<td>从一个 JSON 对象数组构建一个任意的记录集合。正如所有返回record 的函数一样，调用者必须用一个AS子句显式地定义记录的结构。</td>
<td>select * from  json_to_recordset(&rsquo;[{&ldquo;a&rdquo;:1,&ldquo;b&rdquo;:&ldquo;foo&rdquo;},{&ldquo;a&rdquo;:&ldquo;2&rdquo;,&ldquo;c&rdquo;:&ldquo;bar&rdquo;}]&rsquo;)  as x(a int, b text);</td>
<td>a | b  &mdash;+&mdash;&ndash;   1 | foo   2 |</td>
</tr>
<tr>
<td>json_strip_nulls(from_json json)  jsonb_strip_nulls(from_json jsonb)</td>
<td>json  jsonb</td>
<td>返回from_json，其中所有具有空值的 对象域都被省略。其他空值不动。</td>
<td>json_strip_nulls(&rsquo;[{&ldquo;f1&rdquo;:1,&ldquo;f2&rdquo;:null},2,null,3]')</td>
<td>[{&ldquo;f1&rdquo;:1},2,null,3]</td>
</tr>
<tr>
<td>jsonb_set(target jsonb, path text[], new_value  jsonb[, create_missing boolean])</td>
<td>jsonb</td>
<td>返回target，其中由 path指定的节用 new_value替换，如果 path指定的项不存在并且 create_missing为真则加上 new_value。正如面向路径的 操作符一样，出现在path中的 负整数表示从 JSON 数组的末尾开始数。</td>
<td>jsonb_set(&rsquo;[{&ldquo;f1&rdquo;:1,&ldquo;f2&rdquo;:null},2,null,3]&rsquo;,  &lsquo;{0,f1}&rsquo;,&rsquo;[2,3,4]&rsquo;, false)  jsonb_set(&rsquo;[{&ldquo;f1&rdquo;:1,&ldquo;f2&rdquo;:null},2]&rsquo;,  &lsquo;{0,f3}&rsquo;,&rsquo;[2,3,4]&rsquo;)</td>
<td>[{&ldquo;f1&rdquo;:[2,3,4],&ldquo;f2&rdquo;:null},2,null,3]  [{&ldquo;f1&rdquo;: 1, &ldquo;f2&rdquo;: null, &ldquo;f3&rdquo;: [2, 3, 4]},  2]</td>
</tr>
<tr>
<td>jsonb_insert(target jsonb, path text[], new_value jsonb,  [insert_after boolean])</td>
<td>jsonb</td>
<td>返回被插入了new_value的target。如果path指定的target节在一个 JSONB 数组中，new_value将被插入到目标之前（insert_after为false，默认情况）或者之后（insert_after为真）。如果path指定的target节在一个 JSONB 对象内，则只有当target不存在时才插入new_value。对于面向路径的操作符来说，出现在path中的负整数表示从 JSON 数组的末尾开始计数。</td>
<td>jsonb_insert(&rsquo;{&ldquo;a&rdquo;: [0,1,2]}&rsquo;, &lsquo;{a, 1}&rsquo;,  &lsquo;&ldquo;new_value&rdquo;&rsquo;)  jsonb_insert(&rsquo;{&ldquo;a&rdquo;: [0,1,2]}&rsquo;, &lsquo;{a, 1}&rsquo;,  &lsquo;&ldquo;new_value&rdquo;&rsquo;, true)</td>
<td>{&ldquo;a&rdquo;: [0, &ldquo;new_value&rdquo;, 1, 2]}  {&ldquo;a&rdquo;: [0, 1, &ldquo;new_value&rdquo;, 2]}</td>
</tr>
<tr>
<td>jsonb_pretty(from_json jsonb)</td>
<td>text</td>
<td>把from_json返回成一段 缩进后的 JSON 文本。</td>
<td>jsonb_pretty(&rsquo;[{&ldquo;f1&rdquo;:1,&ldquo;f2&rdquo;:null},2,null,3]&rsquo;)</td>
<td>[    {   &ldquo;f1&rdquo;: 1,   &ldquo;f2&rdquo;: null    },    2,    null,    3  ]</td>
</tr>
</tbody>
</table>
</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4e02be4" class="language-sql ">
  <code>drop type if exists json_test_columns;
--根据json结构创建自定义类型
create type json_test_columns as (a int,b int,c int,d int);
--使用自定义类型输出
select * from json_populate_record(null::json_test_columns,&#39;{&#34;a&#34;:1,&#34;b&#34;:2,&#34;c&#34;:3,&#34;d&#34;:4}&#39;);
select * from json_populate_recordset(null::json_test_columns,&#39;[{&#34;a&#34;:1,&#34;b&#34;:2,&#34;c&#34;:3,&#34;d&#34;:4},{&#34;a&#34;:2,&#34;b&#34;:3,&#34;c&#34;:4,&#34;d&#34;:5}]&#39;);
--上面的压缩版本,目前还不支持,我个人觉得应该支持,
-- select * from json_populate_recordset(null::json_test_columns,&#39;[[1,2,3,4],[2,3,4,5]]&#39;);
--变通方法
select value-&gt;&gt;0 as a,value-&gt;&gt;1 as b,value-&gt;&gt;2 as c,value-&gt;&gt;3 as c from (select * from jsonb_array_elements(&#39;[[1,2,3,4],[2,3,4,5]]&#39;)) as tmp;</code>
  </pre>
  </div>
<p>注意:很多这些函数和操作符将把 JSON 字符串中的 Unicode 转义转换成合适的单一字符。如果 输入类型是jsonb，这就没有问题，因为该转换已经完成了。但是对于json 输入，这可能会导致抛出一个错误。</p>
<p>注意:虽然函数json_populate_record、json_populate_recordset、json_to_record以及json_to_recordset的例子使用了常量，但常见的用法是引用FROM子句中的表并且使用其json或jsonb列之一作为函数的参数。然后抽取出的键值可以被查询的其他部分引用，例如WHERE子句和目标列表。以这种方式抽取多个值的性能比用以键为单位的操作符单个抽取它们的性能更好。</p>
<p>JSON键被匹配到目标行类型中的相同列名。这些函数的JSON类型强制是一种“尽力而为”的方式并且对于某些类型可能得不到想要的值。不出现在目标行类型中的JSON字段将从输出中忽略，而且不匹配任何JSON字段的目标列将为NULL。</p>
<p>注意:jsonb_set和jsonb_insert的path参数中除最后一项之外的所有项都必须存在于target中。如果create_missing为假，jsonb_set的path参数的所有项都必须存在。如果这些条件不满足，则返回的target不会被改变。</p>
<p>如果最后的路径项是一个对象键，在它不存在且给定了新值的情况下会创建它。如果最后的路径项是一个数组索引，为正值则表示从左边开始计数，为负值表示从右边开始计数 - -1表示最右边的元素，以此类推。如果该项超过范围 -array_length .. array_length -1 并且 create_missing 为真，则该项为负时把新值加载数组的开始处，而该项为正时把新值加在数组的末尾处。</p>
<p>注意:不要把json_typeof函数的null返回值与 SQL 的 NULL 弄混。 虽然调用json_typeof(&rsquo;null&rsquo;::json)将会返回null，但调用 json_typeof(NULL::json)将会返回一个 SQL 的 NULL。</p>
<p>注意:如果json_strip_nulls的参数在任何对象中包含重复的域名称， 结果在语义上可能有所不同，具体取决于它们发生的顺序。这不是 jsonb_strip_nulls的一个问题，因为jsonb值 不能具有重复的对象域名称。</p>
<h2 id="序列操作函数">序列操作函数 <a href="#%e5%ba%8f%e5%88%97%e6%93%8d%e4%bd%9c%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述用于操作序列对象的函数，序列对象也被称为序列生成器或者就是序列。序列对象都是用CREATE SEQUENCE创建的特殊的单行表。序列对象通常用于为表的行生成唯一的标识符。表中列出的这些序列函数，可以为我们从序列对象中获取连续的序列值提供了简单的、多用户安全的方法。</p>
<p><strong>表</strong> <strong>.</strong> <strong>序列函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>currval(regclass)</td>
<td>bigint</td>
<td>返回最近一次用nextval获取的指定序列的值</td>
</tr>
<tr>
<td>lastval()</td>
<td>bigint</td>
<td>返回最近一次用nextval获取的任何序列的值</td>
</tr>
<tr>
<td>nextval(regclass)</td>
<td>bigint</td>
<td>递增序列并返回新值</td>
</tr>
<tr>
<td>setval(regclass, bigint)</td>
<td>bigint</td>
<td>设置序列的当前值</td>
</tr>
<tr>
<td>setval(regclass, bigint, boolean)</td>
<td>bigint</td>
<td>设置序列的当前值以及is_called标志</td>
</tr>
</tbody>
</table>
</p>
<p><strong>创建序列</strong></p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e655968" class="language-sql ">
  <code>  create sequence public.test_sequece
  increment by 1
  minvalue 10000000
  maxvalue 9999999999
  start with 10000000
  cache 1;</code>
  </pre>
  </div>
<p>查看序列结构</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="312a526" class="language- ">
  <code>\d test_sequece 
                     Sequence &#34;public.test_sequece&#34;
  Type  |  Start   | Minimum  |  Maximum   | Increment | Cycles? | Cache 
--------&#43;----------&#43;----------&#43;------------&#43;-----------&#43;---------&#43;-------
 bigint | 10000000 | 10000000 | 9999999999 |         1 | no      |   100
 
SELECT nextval(&#39;test_sequece&#39;);
 nextval  
----------
 10000000
(1 row)
 
SELECT nextval(&#39;test_sequece&#39;);
 nextval  
----------
 10000001
(1 row)
select currval(&#39;test_sequece&#39;);
 currval  
----------
 10000001
(1 row)
 
SELECT setval(&#39;test_sequece&#39;,  11000001);
  setval  
----------
 11000001
(1 row)
 
select currval(&#39;test_sequece&#39;);
 currval  
----------
 11000001
(1 row)</code>
  </pre>
  </div>
<p>将要由序列函数调用操作的序列是用一个regclass参数声明的， 它只是序列在pg_class系统表里面的 OID。不过，你不需要手工查找 OID， 因为regclass数据类型的输入转换器会帮你做这件事情。 只要写出用单引号包围的序列名字即可，因此它看上去像文本常量。为了和普通SQL名字处理兼容，这个字串将转换成小写形式， 除非在序列名字周围包含双引号。因此：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e7acfd9" class="language-sql ">
  <code>nextval(&#39;test_sequece&#39;);      操作序列test_sequece
nextval(&#39; test_sequece &#39;)      操作序列test_sequece
nextval(&#39; test_Sequece &#34;&#39;)    操作序列test_sequece</code>
  </pre>
  </div>
<p>必要时序列名可以用模式限定∶</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="f078ffd" class="language-sql ">
  <code>nextval(&#39; public.test_sequece &#39;)     操作myschema.foo
nextval(&#39;&#34;public&#34;. test_sequece &#39;) ;   同上
nextval(&#39; test_sequece &#39;)              在搜索路径中查找foo
nextval(&#39; test_sequece &#39;::text)      foo在运行时查找
查看数据库中有哪些序列
--r =普通表， i =索引，S =序列，v =视图，m =物化视图， c =复合类型，t = TOAST表，f =外部表
select *  from pg_class where relkind=&#39;S&#39;</code>
  </pre>
  </div>
<p>可用的序列函数有∶</p>
<p><strong>nextval</strong></p>
<p>递增序列对象到它的下一个值并且返回该值。这个动作是自动完成的： 即使多个会话并发执行nextval，每个进程也会安全地收到一个唯一的序列值。</p>
<p>如果一个序列对象是用默认参数创建的，连续的nextval调用将会返回从 1 开始的连续的值。其他的行为可以通过在CREATE SEQUENCE命令中使用特殊参数来获得；详见该命令的参考页。</p>
<p>重要</p>
<p>为了避免阻塞从同一个序列获取序号的并发事务，nextval操作从来不会被回滚。也就是说，一旦一个值被取出就视同被用掉并且不会被再次返回给调用者，即便调用该操作的外层事务后来中止或者调用查询后来没有使用取得的值也是这样。例如一个带有ON CONFLICT子句的INSERT会计算要被插入的元组，其中可能就包括调用nextval，然后才会检测到导致它转向ON CONFLICT规则的冲突。这种情况就会在已分配值的序列中留下未被使用的“空洞”。因此，序列对象不能被用来得到“无间隙”的序列。</p>
<p>这个函数要求序列上的USAGE或者UPDATE特权。</p>
<p><strong>currval</strong></p>
<p>在当前会话中返回最近一次nextval取到的该序列的值（如果在本会话中从未在该序列上调用过nextval，那么会报告一个错误）。请注意因为此函数返回一个会话本地的值，不论其它会话是否在当前会话之后执行过nextval，它都能给出一个可预测的回答。</p>
<p>这个函数要求序列上的USAGE或者SELECT特权。</p>
<p><strong>lastval</strong></p>
<p>返回当前会话里最近一次nextval返回的值。 这个函数等效于currval，只是它不用序列名作为参数， 它会引用当前会话里面最近一次被应用的序列的nextval。如果当前会话还没有调用过nextval，那么调用lastval会报错。</p>
<p>这个函数要求上一次使用的序列上的USAGE或者SELECT特权。</p>
<p><strong>setval</strong></p>
<p>重置序列对象的计数器值。双参数的形式设置序列的last_value域为指定值并且将其is_called域设置为 true，表示下一次nextval将在返回值之前递增该序列。currval报告的值也被设置为指定的值。在三参数形式里，is_called可以设置为true或false。true具有和双参数形式相同的效果。如果你把它设置为false，那么下一次nextval将返回指定的值，而从随后的nextval才开始递增该序列。此外，在这种情况中currval报告的值不会被改变。 例如：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="37cf0e3" class="language-sql ">
  <code>SELECT setval(&#39; test_sequece &#39;, 10000001);           下一次nextval会返回 43
SELECT setval(&#39; test_sequece &#39;, 10000001, true);     同上
SELECT setval(&#39; test_sequece &#39;, 10000001, false);    下一次nextval将返回 42</code>
  </pre>
  </div>
<p>setval返回的结果就是它的第二个参数的值。</p>
<h2 id="条件表达式">条件表达式 <a href="#%e6%9d%a1%e4%bb%b6%e8%a1%a8%e8%be%be%e5%bc%8f" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述在MemFireDB中可用的SQL兼容的条件表达式。</p>
<h3 id="case">CASE <a href="#case" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3><p>SQL CASE表达式是一种通用的条件表达式，类似于其它编程语言中的 if/else 语句：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="9d1b29a" class="language- ">
  <code>CASE WHEN condition THEN result
     [WHEN ...]
     [ELSE result]
END</code>
  </pre>
  </div>
<p>CASE子句可以用于任何表达式可以出现的地方。每一个condition是一个返回boolean结果的表达式。如果结果为真，那么CASE表达式的结果就是符合条件的result，并且剩下的CASE表达式不会被处理。如果条件的结果不为真，那么以相同方式搜寻任何随后的WHEN子句。如果没有WHEN condition为真，那么CASE表达式的值就是在ELSE子句里的result。如果省略了ELSE子句而且没有条件为真，结果为空。</p>
<p>例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="14fb1c9" class="language- ">
  <code>create table test (a integer);
insert into table test values(1),(2),(3);
SELECT * FROM test;
 
 a
---
 1
 2
 3
 
 
SELECT a,
       CASE WHEN a=1 THEN &#39;one&#39;
            WHEN a=2 THEN &#39;two&#39;
            ELSE &#39;other&#39;
       END
    FROM test;
 
 a | case
---&#43;-------
 1 | one
 2 | two
 3 | other</code>
  </pre>
  </div>
<p>所有result表达式的数据类型都必须可以转换成单一的输出类型。</p>
<p>下面这个“简单”形式的CASE表达式是上述通用形式的一个变种：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="9f9adea" class="language- ">
  <code>CASE expression
    WHEN value THEN result
    [WHEN ...]
    [ELSE result]
END</code>
  </pre>
  </div>
<p>第一个expression会被计算，然后与所有在WHEN子句中的每一个value对比，直到找到一个相等的。如果没有找到匹配的，则返回在ELSE子句中的result（或者控制）。 这类似于 C 里的switch语句。</p>
<p>上面的例子可以用简单CASE语法来写：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="bc92dcd" class="language- ">
  <code>SELECT a,
       CASE a WHEN 1 THEN &#39;one&#39;
              WHEN 2 THEN &#39;two&#39;
              ELSE &#39;other&#39;
       END
    FROM test;
 
 a | case
---&#43;-------
 1 | one
 2 | two
 3 | other</code>
  </pre>
  </div>
<p>CASE表达式并不计算任何无助于判断结果的子表达式。例如，下面是一个可以避免被零除错误的方法：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="1f75b72" class="language- ">
  <code>SELECT ... WHERE CASE WHEN x &lt;&gt; 0 THEN y/x &gt; 1.5 ELSE false END;</code>
  </pre>
  </div>
<h3 id="coalesce">COALESCE <a href="#coalesce" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="0edb79e" class="language- ">
  <code>COALESCE(value [, ...])</code>
  </pre>
  </div>
<p>COALESCE函数返回它的第一个非空参数的值。当且仅当所有参数都为空时才会返回空。它常用于在为显示目的检索数据时用缺省值替换空值。例如：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="342b025" class="language-sql ">
  <code>SELECT COALESCE(description, short_description, &#39;(none)&#39;) ...</code>
  </pre>
  </div>
<p>如果description不为空，这将会返回它的值，否则如果short_description非空则返回short_description的值，如果前两个都为空则返回(none)。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2465b37" class="language-sql ">
  <code>SELECT COALESCE(null,null,now()::varchar, &#39; &#39;);</code>
  </pre>
  </div>
<p>和CASE表达式一样，COALESCE将不会计算无助于判断结果的参数；也就是说，在第一个非空参数右边的参数不会被计算。这个 SQL 标准函数提供了类似于NVL和IFNULL的能力，它们被用在某些其他数据库系统中。</p>
<h3 id="nullif">NULLIF <a href="#nullif" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="f73a64c" class="language- ">
  <code>NULLIF(value1, value2)</code>
  </pre>
  </div>
<p>当value1和value2相等时，NULLIF返回一个空值。 否则它返回value1。 这些可以用于执行前文给出的COALESCE例子的逆操作：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="df8c931" class="language- ">
  <code>SELECT NULLIF(value, &#39;(none)&#39;) ...</code>
  </pre>
  </div>
<p>在这个例子中，如果value是(none)，将返回空值，否则返回value的值。</p>
<h3 id="greatest和least">GREATEST和LEAST <a href="#greatest%e5%92%8cleast" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="dabac65" class="language- ">
  <code>GREATEST(value [, ...])
LEAST(value [, ...])</code>
  </pre>
  </div>
<p>GREATEST和LEAST函数从一个任意的数字表达式列表里选取最大或者最小的数值。 这些表达式必须都可以转换成一个普通的数据类型，它将会是结果类型。列表中的 NULL 数值将被忽略。只有所有表达式的结果都是 NULL 的时候，结果才会是 NULL。</p>
<p>请注意GREATEST和LEAST都不是 SQL 标准，但却是很常见的扩展。某些其他数据库让它们在任何参数为 NULL 时返回 NULL，而不是在所有参数都为 NULL 时才返回 NULL。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="0f54f78" class="language-sql ">
  <code>drop table biztable
create table biztable (
           id int PRIMARY key,
           time1 TIMESTAMP,
           time2 TIMESTAMP,
    time3 TIMESTAMP
);
select * from biztable;
insert into            biztable VALUES(1,&#39;2018-05-20 22:52&#39;,&#39;2019-05-20 22:54&#39;,&#39;2019-05-20 23:52&#39;);
 
select id,GREATEST(time1,time2,time3)as maxval, LEAST(time1,time2,time3) AS minval
from biztable;</code>
  </pre>
  </div>
<h2 id="数组函数与操作符">数组函数与操作符 <a href="#%e6%95%b0%e7%bb%84%e5%87%bd%e6%95%b0%e4%b8%8e%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>显示了可以用于数组类型的操作符。</p>
<p><strong>表.数组操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th>操作符</th>
<th>描述</th>
<th>例子</th>
<th>结果</th>
</tr>
</thead>
<tbody>
<tr>
<td>=</td>
<td>等于</td>
<td>ARRAY[1.1,2.1,3.1]::int[] = ARRAY[1,2,3]</td>
<td>t</td>
</tr>
<tr>
<td>&lt;&gt;</td>
<td>不等于</td>
<td>ARRAY[1,2,3] &lt;&gt; ARRAY[1,2,4]</td>
<td>t</td>
</tr>
<tr>
<td>&lt;</td>
<td>小于</td>
<td>ARRAY[1,2,3] &lt; ARRAY[1,2,4]</td>
<td>t</td>
</tr>
<tr>
<td>&gt;</td>
<td>大于</td>
<td>ARRAY[1,4,3] &gt; ARRAY[1,2,4]</td>
<td>t</td>
</tr>
<tr>
<td>&lt;=</td>
<td>小于等于</td>
<td>ARRAY[1,2,3] &lt;= ARRAY[1,2,3]</td>
<td>t</td>
</tr>
<tr>
<td>&gt;=</td>
<td>大于等于</td>
<td>ARRAY[1,4,3] &gt;= ARRAY[1,4,3]</td>
<td>t</td>
</tr>
<tr>
<td>@&gt;</td>
<td>包含</td>
<td>ARRAY[1,4,3] @&gt; ARRAY[3,1]</td>
<td>t</td>
</tr>
<tr>
<td>&lt;@</td>
<td>被包含</td>
<td>ARRAY[2,7] &lt;@ ARRAY[1,7,4,2,6]</td>
<td>t</td>
</tr>
<tr>
<td>&amp;&amp;</td>
<td>重叠（具有公共元素）</td>
<td>ARRAY[1,4,3] &amp;&amp; ARRAY[2,1]</td>
<td>t</td>
</tr>
<tr>
<td>||</td>
<td>数组和数组串接</td>
<td>ARRAY[1,2,3] || ARRAY[4,5,6]</td>
<td>{1,2,3,4,5,6}</td>
</tr>
<tr>
<td>||</td>
<td>元素到数组串接</td>
<td>3 || ARRAY[4,5,6]</td>
<td>{3,4,5,6}</td>
</tr>
<tr>
<td>||</td>
<td>数组到元素串接</td>
<td>ARRAY[4,5,6] || 7</td>
<td>{4,5,6,7}</td>
</tr>
</tbody>
</table>
</p>
<p><strong>表.数组函数</strong></p>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>array_append(anyarray, anyelement)</td>
<td>anyarray</td>
<td>向一个数组的末端追加一个元素</td>
<td>array_append(ARRAY[1,2],  3)</td>
<td>{1,2,3}</td>
</tr>
<tr>
<td>array_cat(anyarray, anyarray)</td>
<td>anyarray</td>
<td>连接两个数组</td>
<td>array_cat(ARRAY[1,2,3],  ARRAY[4,5])</td>
<td>{1,2,3,4,5}</td>
</tr>
<tr>
<td>array_ndims(anyarray)</td>
<td>int</td>
<td>返回数组的维度数</td>
<td>array_ndims(ARRAY[[1,2,3],  [4,5,6]])</td>
<td>2</td>
</tr>
<tr>
<td>array_dims(anyarray)</td>
<td>text</td>
<td>返回数组的维度的文本表示</td>
<td>array_dims(ARRAY[[1,2,3],  [4,5,6]])</td>
<td>[1:2][1:3]</td>
</tr>
<tr>
<td>array_fill(anyelement, int[],  [, int[]])</td>
<td>anyarray</td>
<td>返回一个用提供的值和维度初始化好的数组，可以选择下界不为  1</td>
<td>array_fill(7,  ARRAY[3], ARRAY[2])</td>
<td>[2:4]={7,7,7}</td>
</tr>
<tr>
<td>array_length(anyarray, int)</td>
<td>int</td>
<td>返回被请求的数组维度的长度</td>
<td>array_length(array[1,2,3],  1)</td>
<td>3</td>
</tr>
<tr>
<td>array_lower(anyarray, int)</td>
<td>int</td>
<td>返回被请求的数组维度的下界</td>
<td>array_lower(&rsquo;[0:2]={1,2,3}&rsquo;::int[],  1)</td>
<td>0</td>
</tr>
<tr>
<td>array_position(anyarray, anyelement [, int])</td>
<td>int</td>
<td>返回在该数组中从第三个参数指定的元素开始或者 第一个元素开始（数组必须是一维的）、第二个参数的 第一次出现的下标</td>
<td>array_position(ARRAY[&lsquo;sun&rsquo;,&lsquo;mon&rsquo;,&rsquo;tue&rsquo;,&lsquo;wed&rsquo;,&rsquo;thu&rsquo;,&lsquo;fri&rsquo;,&lsquo;sat&rsquo;],  &lsquo;mon&rsquo;)</td>
<td>2</td>
</tr>
<tr>
<td>array_positions(anyarray, anyelement)</td>
<td>int[]</td>
<td>返回在第一个参数给定的数组（数组必须是一维的）中， 第二个参数所有出现位置的下标组成的数组</td>
<td>array_positions(ARRAY[&lsquo;A&rsquo;,&lsquo;A&rsquo;,&lsquo;B&rsquo;,&lsquo;A&rsquo;], &lsquo;A&rsquo;)</td>
<td>{1,2,4}</td>
</tr>
<tr>
<td>array_prepend(anyelement, anyarray)</td>
<td>anyarray</td>
<td>向一个数组的首部追加一个元素</td>
<td>array_prepend(1, ARRAY[2,3])</td>
<td>{1,2,3}</td>
</tr>
<tr>
<td>array_remove(anyarray, anyelement)</td>
<td>anyarray</td>
<td>从数组中移除所有等于给定值的所有元素（数组必须是一维的）</td>
<td>array_remove(ARRAY[1,2,3,2], 2)</td>
<td>{1,3}</td>
</tr>
<tr>
<td>array_replace(anyarray, anyelement, anyelement)</td>
<td>anyarray</td>
<td>将每一个等于给定值的数组元素替换成一个新值</td>
<td>array_replace(ARRAY[1,2,5,4], 5, 3)</td>
<td>{1,2,3,4}</td>
</tr>
<tr>
<td>array_to_string(anyarray, text [, text])</td>
<td>text</td>
<td>使用提供的定界符和可选的空串连接数组元素</td>
<td>array_to_string(ARRAY[1,  2, 3, NULL, 5], &lsquo;,&rsquo;, &lsquo;*&rsquo;)</td>
<td>1,2,3,*,5</td>
</tr>
<tr>
<td>array_upper(anyarray, int)</td>
<td>int</td>
<td>返回被请求的数组维度的上界</td>
<td>array_upper(ARRAY[1,8,3,7],  1)</td>
<td>4</td>
</tr>
<tr>
<td>cardinality(anyarray)</td>
<td>int</td>
<td>返回数组中元素的总数，如果数组为空则返回  0</td>
<td>cardinality(ARRAY[[1,2],[3,4]])</td>
<td>4</td>
</tr>
<tr>
<td>string_to_array(text, text [, text])</td>
<td>text[]</td>
<td>使用提供的定界符和可选的空串将字符串划分成数组元素</td>
<td>string_to_array(&lsquo;xx~^~yy~^~zz&rsquo;,  &lsquo;~^~&rsquo;, &lsquo;yy&rsquo;)</td>
<td>{xx,NULL,zz}</td>
</tr>
<tr>
<td>unnest(anyarray)</td>
<td>setof anyelement</td>
<td>将一个数组扩展成一组行</td>
<td>unnest(ARRAY[1,2])</td>
<td>1  2  (2 rows)</td>
</tr>
<tr>
<td>unnest(anyarray, anyarray [,  &hellip;])</td>
<td>setof anyelement,  anyelement [, &hellip;]</td>
<td>把多维数组（可能是不同类型）扩展成一个行的集合。 这只允许用在  FROM 子句中</td>
<td>SELECT * from  unnest(ARRAY[1,2],ARRAY[&lsquo;foo&rsquo;,&lsquo;bar&rsquo;,&lsquo;baz&rsquo;]);</td>
<td>1  foo  2    bar  NULL baz    (3 rows)</td>
</tr>
</tbody>
</table>

<p>在array_position和array_positions中， 每一个数组元素都使用IS NOT DISTINCT FROM 语义与要搜索的值比较。</p>
<p>在array_position中，如果值没有找到则返回 NULL。</p>
<p>在array_positions中，只有当数组为 NULL时才返回NULL，如果该值 没有在该数组中找到则返回一个空数组。</p>
<p>在string_to_array中，如果定界符参数为 NULL，输入字符串中的每一个字符将变成结果数组中的一个独立元素。如果定界符是一个空串，则整个输入字符串被作为一个单一元素的数组返回。否则输入字符串会被在每一个出现定界符字符串的位置分裂。</p>
<p>在string_to_array中，如果空值串参数被忽略或者为 NULL，输入中的子串不会被替换成 NULL。在array_to_string中，如果空值串参数被忽略或者为 NULL，该数组中的任何空值元素会被简单地跳过并且不会在输出串中被表示。</p>
<h2 id="范围函数和操作符">范围函数和操作符 <a href="#%e8%8c%83%e5%9b%b4%e5%87%bd%e6%95%b0%e5%92%8c%e6%93%8d%e4%bd%9c%e7%ac%a6" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>下表 展示了范围类型可用的操作符。</p>
<p><strong>表.范围操作符</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>操作符</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>=</td>
<td>等于</td>
<td>int4range(1,5) = &lsquo;[1,4]&rsquo;::int4range</td>
<td>t</td>
</tr>
<tr>
<td>&lt;&gt;</td>
<td>不等于</td>
<td>numrange(1.1,2.2) &lt;&gt; numrange(1.1,2.3)</td>
<td>t</td>
</tr>
<tr>
<td>&lt;</td>
<td>小于</td>
<td>int4range(1,10) &lt; int4range(2,3)</td>
<td>t</td>
</tr>
<tr>
<td>&gt;</td>
<td>大于</td>
<td>int4range(1,10) &gt; int4range(1,5)</td>
<td>t</td>
</tr>
<tr>
<td>&lt;=</td>
<td>小于等于</td>
<td>numrange(1.1,2.2) &lt;= numrange(1.1,2.2)</td>
<td>t</td>
</tr>
<tr>
<td>&gt;=</td>
<td>大于等于</td>
<td>numrange(1.1,2.2) &gt;= numrange(1.1,2.0)</td>
<td>t</td>
</tr>
<tr>
<td>@&gt;</td>
<td>包含范围</td>
<td>int4range(2,4) @&gt; int4range(2,3)</td>
<td>t</td>
</tr>
<tr>
<td>@&gt;</td>
<td>包含元素</td>
<td>&lsquo;[2011-01-01,2011-03-01)&rsquo;::tsrange @&gt;  &lsquo;2011-01-10&rsquo;::timestamp</td>
<td>t</td>
</tr>
<tr>
<td>&lt;@</td>
<td>范围被包含</td>
<td>int4range(2,4) &lt;@ int4range(1,7)</td>
<td>t</td>
</tr>
<tr>
<td>&lt;@</td>
<td>元素被包含</td>
<td>42 &lt;@ int4range(1,7)</td>
<td>f</td>
</tr>
<tr>
<td>&amp;&amp;</td>
<td>重叠（有公共点）</td>
<td>int8range(3,7) &amp;&amp; int8range(4,12)</td>
<td>t</td>
</tr>
<tr>
<td>&laquo;</td>
<td>严格左部</td>
<td>int8range(1,10) &laquo; int8range(100,110)</td>
<td>t</td>
</tr>
<tr>
<td>&raquo;</td>
<td>严格右部</td>
<td>int8range(50,60) &raquo; int8range(20,30)</td>
<td>t</td>
</tr>
<tr>
<td>&amp;&lt;</td>
<td>不超过右部</td>
<td>int8range(1,20) &amp;&lt; int8range(18,20)</td>
<td>t</td>
</tr>
<tr>
<td>&amp;&gt;</td>
<td>不超过左部</td>
<td>int8range(7,20) &amp;&gt; int8range(5,10)</td>
<td>t</td>
</tr>
<tr>
<td>-|-</td>
<td>相邻</td>
<td>numrange(1.1,2.2) -|- numrange(2.2,3.3)</td>
<td>t</td>
</tr>
<tr>
<td>+</td>
<td>并</td>
<td>numrange(5,15) + numrange(10,20)</td>
<td>[5,20)</td>
</tr>
<tr>
<td>*</td>
<td>交</td>
<td>int8range(5,15) * int8range(10,20)</td>
<td>[10,15)</td>
</tr>
<tr>
<td>-</td>
<td>差</td>
<td>int8range(5,15) -  int8range(10,20)</td>
<td>[5,10)</td>
</tr>
</tbody>
</table>
</p>
<p>简单比较操作符&lt;、 &gt;、&lt;=和 &gt;=首先比较下界，并且只有在下界相等时才比较上界。这些比较通常对范围不怎么有用，但是还是提供它们以便能够在范围上构建 B树索引。</p>
<p>当涉及一个空范围时，左部/右部/相邻操作符总是返回假；即一个空范围被认为不在任何其他范围前面或者后面。</p>
<p>如果结果范围可能需要包含两个分离的子范围，并和差操作符将会失败，因为这样的范围无法被表示。</p>
<p>下表显示可用于范围类型的函数。</p>
<p><strong>表. 范围函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>描述</strong></th>
<th><strong>例子</strong></th>
<th><strong>结果</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>lower(anyrange)</td>
<td>范围的元素类型</td>
<td>范围的下界</td>
<td>lower(numrange(1.1,2.2))</td>
<td>1.1</td>
</tr>
<tr>
<td>upper(anyrange)</td>
<td>范围的元素类型</td>
<td>范围的上界</td>
<td>upper(numrange(1.1,2.2))</td>
<td>2.2</td>
</tr>
<tr>
<td>isempty(anyrange)</td>
<td>boolean</td>
<td>范围为空？</td>
<td>isempty(numrange(1.1,2.2))</td>
<td>false</td>
</tr>
<tr>
<td>lower_inc(anyrange)</td>
<td>boolean</td>
<td>下界包含在内？</td>
<td>lower_inc(numrange(1.1,2.2))</td>
<td>true</td>
</tr>
<tr>
<td>upper_inc(anyrange)</td>
<td>boolean</td>
<td>上界包含在内？</td>
<td>upper_inc(numrange(1.1,2.2))</td>
<td>false</td>
</tr>
<tr>
<td>lower_inf(anyrange)</td>
<td>boolean</td>
<td>下界无限？</td>
<td>lower_inf(&rsquo;(,)&rsquo;::daterange)</td>
<td>true</td>
</tr>
<tr>
<td>upper_inf(anyrange)</td>
<td>boolean</td>
<td>上界无限？</td>
<td>upper_inf(&rsquo;(,)&rsquo;::daterange)</td>
<td>true</td>
</tr>
<tr>
<td>range_merge(anyrange, anyrange)</td>
<td>anyrange</td>
<td>包含两个给定范围的最小范围</td>
<td>range_merge(&rsquo;[1,2)&rsquo;::int4range,  &lsquo;[3,4)&rsquo;::int4range)</td>
<td>[1,4)</td>
</tr>
</tbody>
</table>
</p>
<p>如果范围为空或者被请求的界是无限的，lower和upper函数返回空值。函数lower_inc、upper_inc、lower_inf和upper_inf对一个空范围全部返回假。</p>
<h2 id="聚集函数">聚集函数 <a href="#%e8%81%9a%e9%9b%86%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>聚集函数从一个输入值的集合计算出一个单一值；</p>
<p>聚合函数分为四类：</p>
<p>·   通用聚集函数</p>
<p>·   统计聚集函数</p>
<p>·   有序集聚集函数</p>
<p>·   假象集聚集函数</p>
<p><strong>通用聚集函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>参数类型</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>部分模式</strong></th>
<th><strong>描述</strong></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>array_agg(expression)</td>
<td>任何非数组类型</td>
<td>参数类型的数组</td>
<td>No</td>
<td>输入值（包括空）被连接到一个数组</td>
<td></td>
</tr>
<tr>
<td>array_agg(expression)</td>
<td>任意数组类型</td>
<td>和参数数据类型相同</td>
<td>No</td>
<td>输入数组被串接到一个更高维度的数组中 （输入必须都具有相同的维度并且不能为空或者 NULL）</td>
<td></td>
</tr>
<tr>
<td>avg(expression)</td>
<td>smallint, int, bigint、real、double precision、numeric或interval</td>
<td>对于任何整数类型参数是numeric，对于一个浮点参数是double precision，否则和参数数据类型相同</td>
<td>Yes</td>
<td>所有输入值的平均值（算术平均）</td>
<td></td>
</tr>
<tr>
<td>bit_and(expression)</td>
<td>smallint、int、bigint或bit</td>
<td>与参数数据类型相同</td>
<td>Yes</td>
<td>所有非空输入值的按位与，如果没有非空值则结果是空值</td>
<td></td>
</tr>
<tr>
<td>bit_or(expression)</td>
<td>smallint, int, bigint, or bit</td>
<td>与参数数据类型相同</td>
<td>Yes</td>
<td>所有非空输入值的按位或，如果没有非空值则结果是空值</td>
<td></td>
</tr>
<tr>
<td>bool_and(expression)</td>
<td>bool</td>
<td>bool</td>
<td>Yes</td>
<td>如果所有输入值为真则结果为真，否则为假</td>
<td></td>
</tr>
<tr>
<td>bool_or(expression)</td>
<td>bool</td>
<td>bool</td>
<td>Yes</td>
<td>至少一个输入值为真时结果为真，否则为假</td>
<td></td>
</tr>
<tr>
<td>count(*)</td>
<td></td>
<td>bigint</td>
<td>Yes</td>
<td>输入的行数</td>
<td></td>
</tr>
<tr>
<td>count(expression)</td>
<td>any</td>
<td>bigint</td>
<td>Yes</td>
<td>expression值非空的输入行的数目</td>
<td></td>
</tr>
<tr>
<td>every(expression)</td>
<td>bool</td>
<td>bool</td>
<td>Yes</td>
<td>等价于bool_and</td>
<td></td>
</tr>
<tr>
<td>json_agg(expression)</td>
<td>any</td>
<td>json</td>
<td>No</td>
<td>将值聚集成一个 JSON 数组</td>
<td></td>
</tr>
<tr>
<td>jsonb_agg(expression)</td>
<td>any</td>
<td>jsonb</td>
<td>No</td>
<td>把值聚合成一个 JSON 数组</td>
<td></td>
</tr>
<tr>
<td>json_object_agg(name, value)</td>
<td>(any, any)</td>
<td>json</td>
<td>No</td>
<td>将名字/值对聚集成一个 JSON 对象</td>
<td></td>
</tr>
<tr>
<td>jsonb_object_agg(name, value)</td>
<td>(any, any)</td>
<td>jsonb</td>
<td>No</td>
<td>把名字/值对聚合成一个 JSON 对象</td>
<td></td>
</tr>
<tr>
<td>max(expression)</td>
<td>任意数组、数字、串、日期/时间、网络或者枚举类型，或者这些类型的数组</td>
<td>与参数数据类型相同</td>
<td>Yes</td>
<td>所有输入值中expression的最大值</td>
<td></td>
</tr>
<tr>
<td>min(expression)</td>
<td>任意数组、数字、串、日期/时间、网络或者枚举类型，或者这些类型的数组</td>
<td>与参数数据类型相同</td>
<td>Yes</td>
<td>所有输入值中expression的最小值</td>
<td></td>
</tr>
<tr>
<td>string_agg(expression, delimiter)</td>
<td>(text, text) 或 (bytea, bytea)</td>
<td>与参数数据类型相同</td>
<td>No</td>
<td>输入值连接成一个串，用定界符分隔</td>
<td></td>
</tr>
<tr>
<td>sum(expression)</td>
<td>smallint、int、 bigint、real、double precision、numeric、 interval或money</td>
<td>对smallint或int参数是bigint，对bigint参数是numeric，否则和参数数据类型相同</td>
<td>Yes</td>
<td>所有输入值的expression的和</td>
<td></td>
</tr>
<tr>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
</p>
<p>对于array_agg()，string_agg()，jsonb_agg()，和json_agg()，所述列表顺序是由确定ORDER BY子句中的SELECT列表表达式调用的聚合函数。由于jsonb_object_agg()（和json_object_agg()）产生的单个值是一个JSON对象，并且由于该值的元素没有顺序，ORDER BY因此SELECT列表表达式中的子句无效。</p>
<p><strong>用于统计的聚集函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>参数类型</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>部分模式</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>corr(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>相关系数</td>
</tr>
<tr>
<td>covar_pop(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>总体协方差</td>
</tr>
<tr>
<td>covar_samp(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>样本协方差</td>
</tr>
<tr>
<td>regr_avgx(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>自变量的平均值 （sum(X)/N）</td>
</tr>
<tr>
<td>regr_avgy(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>因变量的平均值 （sum(Y)/N）</td>
</tr>
<tr>
<td>regr_count(Y, X)</td>
<td>double precision</td>
<td>bigint</td>
<td>Yes</td>
<td>两个表达式都不为空的输入行的数目</td>
</tr>
<tr>
<td>regr_intercept(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>由（X, Y）对决定的最小二乘拟合的线性方程的 y截距</td>
</tr>
<tr>
<td>regr_r2(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>相关系数的平方</td>
</tr>
<tr>
<td>regr_slope(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>由（X, Y）对决定的最小二乘拟合的线性方程的斜率</td>
</tr>
<tr>
<td>regr_sxx(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>sum(X^2) - sum(X)^2/N（自变量的“平方和”）</td>
</tr>
<tr>
<td>regr_sxy(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>sum(X*Y) - sum(X) * sum(Y)/N（自变量乘以因变量的“积之合”）</td>
</tr>
<tr>
<td>regr_syy(Y, X)</td>
<td>double precision</td>
<td>double precision</td>
<td>Yes</td>
<td>sum(Y^2) - sum(Y)^2/N（因变量的“平方和”）</td>
</tr>
<tr>
<td>stddev(expression)</td>
<td>smallint、int、 bigint、real、double precision或numeric</td>
<td>浮点参数为double precision，否则为numeric</td>
<td>Yes</td>
<td>stddev_samp的历史别名</td>
</tr>
<tr>
<td>stddev_pop(expression)</td>
<td>smallint、int、 bigint、real、double precision或numeric</td>
<td>浮点参数为double precision，否则为numeric</td>
<td>Yes</td>
<td>输入值的总体标准偏差</td>
</tr>
<tr>
<td>stddev_samp(expression)</td>
<td>smallint、int、 bigint、real、double precision或numeric</td>
<td>浮点参数为double precision，否则为numeric</td>
<td>Yes</td>
<td>输入值的样本标准偏差</td>
</tr>
<tr>
<td>variance(expression)</td>
<td>smallint、int、 bigint、real、double precision或numeric</td>
<td>浮点参数为double precision，否则为numeric</td>
<td>Yes</td>
<td>var_samp的历史别名</td>
</tr>
<tr>
<td>var_pop(expression)</td>
<td>smallint、int、 bigint、real、double precision或numeric</td>
<td>浮点参数为double precision，否则为numeric</td>
<td>Yes</td>
<td>输入值的总体方差（总体标准偏差的平方）</td>
</tr>
<tr>
<td>var_samp(expression)</td>
<td>smallint、int、 bigint、real、double precision或numeric</td>
<td>浮点参数为double precision，否则为numeric</td>
<td>Yes</td>
<td>输入值的样本方差（样本标准偏差的平方）</td>
</tr>
</tbody>
</table>
</p>
<p>可以通过以下两种方法之一调用此类中的聚合函数：</p>
<p>·   GROUP BY当表中的所有行返回一组行的单个值时，<em>要么</em>“通常”在表中的所有行上，要么与结合。在这种用法中，行排序无关紧要。</p>
<p>·   <em>或</em>作为窗口函数用OVER。在此用法中，针对窗口中的每一行评估聚合函数时，排序始终很重要。</p>
<p><strong>有序集聚集函数</strong></p>
<p>只能使用专用WITHIN GROUP (ORDER BY &hellip;)语法来调用它们。他们不能被调用的窗函数有OVER。







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>直接参数类型</th>
<th>聚集参数类型</th>
<th>返回类型</th>
<th>部分模式</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>mode() WITHIN GROUP (ORDER BY sort_expression)</td>
<td></td>
<td>任何可排序类型</td>
<td>与排序表达式相同</td>
<td>No</td>
<td>返回最频繁的输入值（如果有多个频度相同的值就选第一个）</td>
</tr>
<tr>
<td>percentile_cont(fraction) WITHIN GROUP (ORDER BY sort_expression)</td>
<td>double precision</td>
<td>double precision或者interval</td>
<td>与排序表达式相同</td>
<td>No</td>
<td>连续百分率：返回一个对应于排序中指定分数的值，如有必要就在相邻的输入项之间插值</td>
</tr>
<tr>
<td>percentile_cont(fractions) WITHIN GROUP (ORDER BY sort_expression)</td>
<td>double precision[]</td>
<td>double precision或者interval</td>
<td>排序表达式的类型的数组</td>
<td>No</td>
<td>多重连续百分率：返回一个匹配fractions参数形状的结果数组， 其中每一个非空元素都用对应于那个百分率的值替换</td>
</tr>
<tr>
<td>percentile_disc(fraction) WITHIN GROUP (ORDER BY sort_expression)</td>
<td>double precision</td>
<td>一种可排序类型</td>
<td>与排序表达式相同</td>
<td>No</td>
<td>离散百分率：返回第一个在排序中位置等于或者超过指定分数的输入值</td>
</tr>
<tr>
<td>percentile_disc(fractions) WITHIN GROUP (ORDER BY sort_expression)</td>
<td>double precision[]</td>
<td>任何可排序类型</td>
<td>排序表达式的类型的数组</td>
<td>No</td>
<td>多重离散百分率：返回一个匹配fractions参数形状的结果数组， 其中每一个非空元素都用对应于那个百分率的输入值替换</td>
</tr>
</tbody>
</table>
</p>
<p><strong>假想集聚集函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th>直接参数类型</th>
<th>聚集参数类型</th>
<th>返回类型</th>
<th>部分模式</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>rank(args) WITHIN GROUP (ORDER BY sorted_args)</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>bigint</td>
<td>No</td>
<td>假想行的排名，为重复的行留下间隔</td>
</tr>
<tr>
<td>dense_rank(args) WITHIN GROUP (ORDER BY sorted_args)</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>bigint</td>
<td>No</td>
<td>假想行的排名，不留间隔</td>
</tr>
<tr>
<td>percent_rank(args) WITHIN GROUP (ORDER BY sorted_args)</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>double precision</td>
<td>No</td>
<td>假想行的相对排名，范围从 0 到 1</td>
</tr>
<tr>
<td>cume_dist(args) WITHIN GROUP (ORDER BY sorted_args)</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>VARIADIC &ldquo;any&rdquo;</td>
<td>double precision</td>
<td>No</td>
<td>假想行的相对排名，范围从 1/N 到 1</td>
</tr>
</tbody>
</table>
</p>
<p><strong>表. 分组操作</strong></p>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>GROUPING(args&hellip;)</td>
<td>integer</td>
<td>整数位掩码指示哪些参数不被包括在当前分组集合中</td>
</tr>
</tbody>
</table>

<p>分组操作用来与分组集合共同来区分结果行。GROUPING操作的参数并不会被实际计算，但是它们必 须准确地匹配在相关查询层次的GROUP BY子句中给定的表达式。 最右边参数指派的位是最低有效位，如果对应的表达式被包括在产生结果行的分组 集合的分组条件中则每一位是 0，否则是 1。例如：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="a5d81f4" class="language- ">
  <code>=&gt; SELECT * FROM items_sold;
 make  | model | sales
-------&#43;-------&#43;-------
 Foo   | GT    |  10
 Foo   | Tour  |  20
 Bar   | City  |  15
 Bar   | Sport |  5
(4 rows)
 
=&gt; SELECT make, model, GROUPING(make,model), sum(sales) FROM items_sold GROUP BY ROLLUP(make,model);
 make  | model | grouping | sum
-------&#43;-------&#43;----------&#43;-----
 Foo   | GT    |        0 | 10
 Foo   | Tour  |        0 | 20
 Bar   | City  |        0 | 15
 Bar   | Sport |        0 | 5
 Foo   |       |        1 | 30
 Bar   |       |        1 | 20
       |       |        3 | 50
(7 rows)</code>
  </pre>
  </div>
<h2 id="窗口函数">窗口函数 <a href="#%e7%aa%97%e5%8f%a3%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>窗口函数提供在与当前查询行相关的行集合上执行计算的能力。注意：必须使用窗口函数的语法调用这些函数； 一个OVER子句是必需的。</p>
<p><strong>通用窗口函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>row_number()</td>
<td>当前行在其分区中的行号，从1计</td>
</tr>
<tr>
<td>rank()</td>
<td>带间隙的当前行排名； 与该行的第一个同等行的row_number相同</td>
</tr>
<tr>
<td>dense_rank()</td>
<td>不带间隙的当前行排名； 这个函数计数同等组</td>
</tr>
<tr>
<td>percent_rank()</td>
<td>当前行的相对排名： (rank- 1) / (总行数 - 1)</td>
</tr>
<tr>
<td>cume_dist()</td>
<td>累积分布：(在当前行之前或者平级的分区行数) / 分区行总数</td>
</tr>
<tr>
<td>ntile()</td>
<td>从1到参数值的整数范围，尽可能等分分区</td>
</tr>
<tr>
<td>lag(value anyelement [, offset integer [, default anyelement ]])</td>
<td>返回value，它在分区内当前行的之前offset个位置的行上计算；如果没有这样的行，返回default替代（必须和value类型相同）。offset和default都是根据当前行计算的结果。如果忽略它们，则offset默认是1，default默认是空值</td>
</tr>
<tr>
<td>lead(value anyelement [, offset integer [, default anyelement ]])</td>
<td>返回value，它在分区内当前行的之后offset个位置的行上计算；如果没有这样的行，返回default替代（必须和value类型相同）。offset和default都是根据当前行计算的结果。如果忽略它们，则offset默认是1，default默认是空值</td>
</tr>
<tr>
<td>first_value()</td>
<td>返回在窗口帧中第一行上计算的值</td>
</tr>
<tr>
<td>last_value()</td>
<td>返回在窗口帧中最后一行上计算的值</td>
</tr>
<tr>
<td>nth_value()</td>
<td>返回在窗口帧中第n行（行从1计数）上计算的值；没有这样的行则返回空值</td>
</tr>
</tbody>
</table>
</p>
<h2 id="子查询表达式">子查询表达式 <a href="#%e5%ad%90%e6%9f%a5%e8%af%a2%e8%a1%a8%e8%be%be%e5%bc%8f" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述MemFireDB中可用的SQL兼容的子查询表达式。所有本节中成文的表达式都返回布尔值（真/假）结果。</p>
<h3 id="exists">EXISTS <a href="#exists" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="c7a3748" class="language- ">
  <code>EXISTS (subquery)</code>
  </pre>
  </div>
<p>EXISTS的参数是一个任意的SELECT语句， 或者说子查询。系统对子查询进行运算以判断它是否返回行。如果它至少返回一行，那么EXISTS的结果就为“真”； 如果子查询没有返回行，那么EXISTS的结果是“假”。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="c0eb915" class="language- ">
  <code>NOT EXISTS (subquery)
not exists与exists正好相反，如果子查询没有返回结果，为&#39;TRUE&#39;，否则&#39;FALSE&#39;。</code>
  </pre>
  </div>
<p>子查询可以引用来自周围的查询的变量，这些变量在该子查询的任何一次计算中都起常量的作用。</p>
<p>这个子查询通常只是运行到能判断它是否可以返回至少一行为止， 而不是等到全部结束。在这里写任何有副作用的子查询都是不明智的（例如调用序列函数）；这些副作用是否发生是很难判断的。</p>
<p>因为结果只取决于是否会返回行，而不取决于这些行的内容， 所以这个子查询的输出列表通常是无关紧要的。一个常用的编码习惯是用EXISTS(SELECT 1 WHERE &hellip;)的形式写所有的EXISTS测试。不过这条规则有例外，例如那些使用INTERSECT的子查询。</p>
<p>下面这个简单的例子类似在col2上的一次内联接，但是它为每个 tab1的行生成最多一个输出，即使存在多个匹配tab2的行也如此∶</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="623f4f6" class="language-sql ">
  <code>SELECT col1
FROM tab1
WHERE EXISTS (SELECT 1 FROM tab2 WHERE col2 = tab1.col2);</code>
  </pre>
  </div>
<h3 id="in">IN <a href="#in" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="cc583f8" class="language- ">
  <code>expression IN (subquery)</code>
  </pre>
  </div>
<p>右手边是一个圆括弧括起来的子查询， 它必须正好只返回一个列。左手边表达式将被计算并与子查询结果逐行进行比较。 如果找到任何等于子查询行的情况，那么IN的结果就是“真”。 如果没有找到相等行，那么结果是“假”（包括子查询没有返回任何行的情况）。</p>
<p>请注意如果左手边表达式得到空值，或者没有相等的右手边值， 并且至少有一个右手边行得到空值，那么IN结构的结果将是空值，而不是假。这个行为是遵照 SQL 处理空值的一般规则的。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4c91b2c" class="language-sql ">
  <code>DROP TABLE COMPANY;
CREATE TABLE COMPANY(
   ID INT PRIMARY KEY     NOT NULL,
   NAME           TEXT    NOT NULL,
   AGE            INT     NOT NULL,
   ADDRESS        CHAR(50),
   SALARY         REAL
);
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (1, &#39;Paul&#39;, 32, &#39;California&#39;, 20000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (2, &#39;Allen&#39;, 25, &#39;Texas&#39;, 15000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (3, &#39;Teddy&#39;, 23, &#39;Norway&#39;, 20000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (4, &#39;Mark&#39;, 25, &#39;Rich-Mond &#39;, 65000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (5, &#39;David&#39;, 27, &#39;Texas&#39;, 85000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (6, &#39;Kim&#39;, 22, &#39;South-Hall&#39;, 45000.00 );
INSERT INTO COMPANY VALUES (7, &#39;James&#39;, 24, &#39;Houston&#39;, 10000.00 );
SELECT * FROM COMPANY WHERE ID IN (SELECT ID FROM COMPANY  WHERE SALARY &gt; 45000) ;</code>
  </pre>
  </div>
<p>和EXISTS一样，假设子查询将被完成运行完全是不明智的。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4038b64" class="language- ">
  <code>row_constructor IN (subquery)</code>
  </pre>
  </div>
<p>这种形式的IN的左手边是一个行构造器。 右手边是一个圆括弧子查询，它必须返回和左手边返回的行中表达式所构成的完全一样多的列。 左手边表达式将被计算并与子查询结果逐行进行比较。如果找到任意相等的子查询行，则IN的结果为“真”。如果没有找到相等行， 那么结果为“假”（包括子查询不返回行的情况）。</p>
<p>通常，表达式或者子查询行里的空值是按照 SQL 布尔表达式的一般规则进行组合的。 如果两个行对应的成员都非空并且相等，那么认为这两行相等；如果任意对应成员为非空且不等，那么这两行不等； 否则这样的行比较的结果是未知（空值）。如果所有行的结果要么是不等， 要么是空值，并且至少有一个空值，那么IN的结果是空值。</p>
<h3 id="not-in">NOT IN <a href="#not-in" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="ab89334" class="language- ">
  <code>expression NOT IN (subquery)</code>
  </pre>
  </div>
<p>右手边是一个用圆括弧包围的子查询，它必须返回正好一个列。左手边表达式将被计算并与子查询结果逐行进行比较。 如果只找到不相等的子查询行（包括子查询不返回行的情况），那么NOT IN的结果是“真”。 如果找到任何相等行，则结果为“假”。</p>
<p>请注意如果左手边表达式得到空值，或者没有相等的右手边值， 并且至少有一个右手边行得到空值，那么NOT IN结构的结果将是空值，而不是真。这个行为是遵照 SQL 处理空值的一般规则的。</p>
<p>和EXISTS一样，假设子查询会完全结束是不明智的。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="dc9f2fa" class="language- ">
  <code>row_constructor NOT IN (subquery)</code>
  </pre>
  </div>
<p>这种形式的NOT IN的左手边是一个行构造器。 右手边是一个圆括弧子查询，它必须返回和左手边返回的行中表达式所构成的完全一样多的列。 左手边表达式将被计算并与子查询结果逐行进行比较。如果找到不等于子查询行的行，则NOT IN的结果为“真”。如果找到相等行， 那么结果为“假”（包括子查询不返回行的情况）。</p>
<p>通常，表达式或者子查询行里的空值是按照 SQL 布尔表达式的一般规则进行组合的。 如果两个行对应的成员都非空并且相等，那么认为这两行相等；如果任意对应成员为非空且不等，那么这两行不等； 否则这样的行比较的结果是未知（空值）。如果所有行的结果要么是不等， 要么是空值，并且至少有一个空值，那么NOT IN的结果是空值。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="d53ab82" class="language-sql ">
  <code>SELECT * FROM COMPANY WHERE ID not IN (SELECT ID FROM COMPANY  WHERE SALARY &gt; 45000) ;</code>
  </pre>
  </div>
<h3 id="anysome">ANY/SOME <a href="#anysome" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="4de68b0" class="language- ">
  <code>expression operator ANY (subquery)
expression operator SOME (subquery)</code>
  </pre>
  </div>
<p>这种形式的右手边是一个圆括弧括起来的子查询， 它必须返回正好一个列。左手边表达式将被计算并使用给出的 操作符对子查询结果逐行进行比较。如果获得任何真值结果，那么ANY的结果就是“真”。 如果没有找到真值结果，那么结果是“假”（包括子查询没有返回任何行的情况）。</p>
<p>SOME是ANY的同义词。IN等价于= ANY。</p>
<p>请注意如果没有任何成功并且至少有一个右手边行为该操作符结果生成空值， 那么ANY结构的结果将是空值，而不是假。 这个行为是遵照 SQL 处理空值布尔组合的一般规则制定的。</p>
<p>和EXISTS一样，假设子查询将被完全运行是不明智的。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="620155f" class="language- ">
  <code>row_constructor operator ANY (subquery)
row_constructor operator SOME (subquery)</code>
  </pre>
  </div>
<p>这种形式的左手边是一个行构造器。右手边是一个圆括弧括起来的子查询， 它必须返回和左手边列表给出的表达式一样多的列。左手边表达式将被计算并使用给出的操作符对子查询结果逐行进行比较。如果比较为任何子查询行返回真，则ANY的结果为“真”。如果比较对每一个子查询行都返回假，则结果为“假”（包括子查询不返回行的情况）。如果比较不对任何行返回真并且至少对一行返回 NULL，则结果为 NULL。</p>
<h3 id="all">ALL <a href="#all" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="e80a156" class="language- ">
  <code>expression operator ALL (subquery)</code>
  </pre>
  </div>
<p>ALL 的这种形式的右手边是一个圆括弧括起来的子查询， 它必须只返回一列。左手边表达式将被计算并使用给出的 操作符对子查询结果逐行进行比较。该操作符必须生成布尔结果。 如果所有行得到真（包括子查询没有返回任何行的情况），ALL的结果就是“真”。如果没有存在任何假值结果，那么结果是“假”。如果比较为任何行都不返回假并且对至少一行返回 NULL，则结果为 NULL。</p>
<p>NOT IN等价于&lt;&gt; ALL。</p>
<p>和EXISTS一样，假设子查询将被完全运行是不明智的。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="0e86292" class="language- ">
  <code>row_constructor operator ALL (subquery)</code>
  </pre>
  </div>
<p>ALL的这种形式的左手边是一个行构造器。 右手边是一个圆括弧括起来的子查询，它必须返回和左手边行中表达式一样多的列。 左手边表达式将被计算并使用给出的 操作符对子查询结果逐行进行比较。如果对所有子查询行该比较都返回真，那么ALL的结果就是“真”（包括子查询没有返回任何行的情况）。如果对任何子查询行比较返回假，则结果为“假”。如果比较对任何子查询行都不返回假并且对至少一行返回 NULL，则结果为 NULL。</p>
<h3 id="单一行比较">单一行比较 <a href="#%e5%8d%95%e4%b8%80%e8%a1%8c%e6%af%94%e8%be%83" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="6644e04" class="language- ">
  <code>row_constructor operator (subquery)</code>
  </pre>
  </div>
<p>左手边是一个行构造器，。 右手边是一个圆括弧括起来的子查询，该查询必须返回和左手边行中表达式数目完全一样的列。 另外，该子查询不能返回超过一行的数量（如果它返回零行，那么结果就是空值）。 左手边被计算并逐行与右手边的子查询结果行比较。</p>
<h2 id="行与数组比较">行与数组比较 <a href="#%e8%a1%8c%e4%b8%8e%e6%95%b0%e7%bb%84%e6%af%94%e8%be%83" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述几个特殊的结构，用于在值的组之间进行多重比较。这些形式语法上和前面一节的子查询形式相关，但是不涉及子查询。所有本节记录的表达式形式都返回布尔（Boolean）结果（真/假）。</p>
<h3 id="in-1">IN <a href="#in-1" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="760c803" class="language- ">
  <code>expression IN (value [, ...])</code>
  </pre>
  </div>
<p>右手边是一个圆括弧包围的标量列表。如果左手边表达式的结果等于任何右手边表达式中的一个，结果为“真”。它是下面形式的缩写</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="69bee21" class="language- ">
  <code>expression = value1
OR
expression = value2
OR
...</code>
  </pre>
  </div>
<p>请注意如果左手边表达式得到空值，或者没有相等的右手边值并且至少有一个右手边的表达式得到空值，那么IN结构的结果将为空值，而不是假。这符合 SQL 处理空值的布尔组合的一般规则。</p>
<h3 id="not-in-1">NOT IN <a href="#not-in-1" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="5191a14" class="language- ">
  <code>expression NOT IN (value [, ...])</code>
  </pre>
  </div>
<p>右手边是一个圆括弧包围的标量列表。如果左手边表达式的结果不等于所有右手边表达式，结果为“真”。它是下面形式的缩写</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="3e50736" class="language- ">
  <code>expression &lt;&gt; value1
AND
expression &lt;&gt; value2
AND
...</code>
  </pre>
  </div>
<p>请注意如果左手边表达式得到空值，或者没有相等的右手边值并且至少有一个右手边的表达式得到空值，那么NOT IN结构的结果将为空值， 而不是我们可能天真地认为的真值。这符合 SQL 处理空值的布尔组合的一般规则。</p>
<p>提示</p>
<p>x NOT IN y在所有情况下都等效于NOT (x IN y)。但是，在处理空值的时候，用NOT IN比用IN更可能迷惑新手。最好尽可能用正逻辑来表达你的条件。</p>
<h3 id="anysome-array">ANY/SOME (array) <a href="#anysome-array" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="462e4f2" class="language- ">
  <code>expression operator ANY (array expression)
expression operator SOME (array expression)</code>
  </pre>
  </div>
<p>右手边是一个圆括弧包围的表达式，它必须得到一个数组值。左手边表达式被计算并且使用给出的操作符对数组的每个元素进行比较，这个操作符必须得到布尔结果。如果得到了任何真值结果，那么ANY的结果是“真”。 如果没有找到真值结果（包括数组只有零个元素的情况），那么结果是“假”。</p>
<p>如果数组表达式得到一个空数组，ANY的结果将为空值。如果左手边的表达式得到空值，ANY通常是空值（尽管一个非严格比较操作符可能得到一个不同的结果）。另外，如果右手边的数组包含任何空值元素或者没有得到真值比较结果，ANY的结果将是空值而不是假（再次，假设是一个严格的比较操作符）。这符合 SQL 对空值的布尔组合的一般规则。</p>
<p>SOME是ANY的同义词。</p>
<h3 id="all-array">ALL (array) <a href="#all-array" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="70a2527" class="language- ">
  <code>expression operator ALL (array expression)</code>
  </pre>
  </div>
<p>右手边是一个圆括弧包围的表达式，它必须得到一个数组值。左手边表达式将被计算并使用给出的操作符与数组的每个元素进行比较，这个操作符必须得到一个布尔结果。如果所有比较都得到真值结果，那么ALL的结果是 “真”（包括数组只有零个元素的情况）。如果有任何假值结果，那么结果是“假”。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="bd26d9f" class="language-sql ">
  <code>create table t1(id  int);
insert into t1 Values (1), (2),(3);
select * from t1 where t1 in (2,5,6);
select * from t1 where id not  in (2,5,6);
select * from t1 where id &lt; any(array[1,3]);
select * from t1 where id &gt; some(array[1,3]);
select * from t1 where id &lt; ALL(array[3]);</code>
  </pre>
  </div>
<p>如果数组表达式得到一个空数组，ALL的结果将为空值。如果左手边的表达式得到空值，ALL通常是空值（尽管一个非严格比较操作符可能得到一个不同的结果）。另外，如果右手边的数组包含任何空值元素或者没有得到假值比较结果，ALL的结果将是空值而不是真（再次，假设是一个严格的比较操作符）。这符合 SQL 对空值的布尔组合的一般规则。</p>
<h3 id="行构造器比较">行构造器比较 <a href="#%e8%a1%8c%e6%9e%84%e9%80%a0%e5%99%a8%e6%af%94%e8%be%83" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="3087a15" class="language- ">
  <code>row_constructor operator row_constructor</code>
  </pre>
  </div>
<p>每一边都是一个行构造器。两个行值必须具有相同数量的域。每一边被计算并且被逐行比较。当操作符是 =、 &lt;&gt;、 &lt; &lt;=、 &gt;、 &gt;=时，允许进行行构造器比较。</p>
<p>=和&lt;&gt;情况略有不同。如果两行的所有对应成员都是非空且相等则这两行被认为相等；如果任何对应成员是非空但是不相等则这两行不相等；否则行比较的结果为未知（空值）。</p>
<p>对于&lt;、&lt;=、&gt;和&gt;=情况，行元素被从左至右比较，在找到一处不等的或为空的元素对就立刻停下来。如果这一对元素都为空值，则行比较的结果为未知（空值）；否则这一对元素的比较结果决定行比较的结果。例如，ROW(1,2,NULL) &lt; ROW(1,3,0)得到真，而不是空值，因为第三对元素并没有被考虑。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2f618fd" class="language- ">
  <code>row_constructor IS DISTINCT FROM row_constructor</code>
  </pre>
  </div>
<p>这个结构与&lt;&gt;行比较相似，但是它对于空值输入不会得到空值。任何空值被认为和任何非空值不相等（有区别），并且任意两个空值被认为相等（无区别）。因此结果将总是为真或为假，永远不会是空值。</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="2ced726" class="language- ">
  <code>row_constructor IS NOT DISTINCT FROM row_constructor</code>
  </pre>
  </div>
<p>这个结构与=行比较相似，但是它对于空值输入不会得到空值。任何空值被认为和任何非空值不相等（有区别），并且任意两个空值被认为相等（无区别）。因此结果将总是为真或为假，永远不会是空值。</p>
<h3 id="组合类型比较">组合类型比较 <a href="#%e7%bb%84%e5%90%88%e7%b1%bb%e5%9e%8b%e6%af%94%e8%be%83" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h3>


  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="19b2d38" class="language- ">
  <code>record operator record</code>
  </pre>
  </div>
<p>SQL 规范要求在结果依赖于比较两个 NULL 值或者一个 NULL 与一个非 NULL 时逐行比较返回 NULL。PostgreSQL只有在比较两个行构造器的结果或者比较一个行构造器与一个子查询的输出时才这样做。在其他比较两个组合类型值的环境中，两个 NULL 域值被认为相等，并且一个 NULL 被认为大于一个非 NULL。为了得到组合类型的一致的排序和索引行为，这样做是必要的。</p>
<h2 id="集合返回函数">集合返回函数 <a href="#%e9%9b%86%e5%90%88%e8%bf%94%e5%9b%9e%e5%87%bd%e6%95%b0" class="anchor" aria-hidden="true"><i class="material-icons align-middle">link</i></a></h2><p>本节描述那些可能返回多于一行的函数。目前这个类中被使用最广泛的是级数生成函数， 如表所述。其他更特殊的集合返回函数在本手册的其他地方描述。</p>
<p><strong>表.级数生成函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th><strong>函数</strong></th>
<th><strong>参数类型</strong></th>
<th><strong>返回类型</strong></th>
<th><strong>描述</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td>generate_series(start, stop)</td>
<td>int、bigint或者numeric</td>
<td>setof int、setof bigint或者setof numeric（与参数类型相同）</td>
<td>产生一系列值，从start到stop，步长为 1</td>
</tr>
<tr>
<td>generate_series(start, stop, step)</td>
<td>int、bigint或者numeric</td>
<td>setof int、setof bigint或者setof numeric（与参数类型相同）</td>
<td>产生一系列值，从start到stop，步长为step</td>
</tr>
<tr>
<td>generate_series(start, stop, step interval)</td>
<td>timestamp或timestamp with time  zone</td>
<td>setof timestamp或setof timestamp with time zone（和参数类型相同）</td>
<td>产生一系列值，从start到stop，步长为step</td>
</tr>
</tbody>
</table>
</p>
<p>当step为正时，如果start大于stop则返回零行。相反，当step为负时，如果start小于stop则返回零行。对于NULL输入也会返回零行。step为零是一个错误。下面是一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="6923a46" class="language- ">
  <code>SELECT * FROM generate_series(2,4);
 generate_series
-----------------
               2
               3
               4
(3 rows)
 
SELECT * FROM generate_series(5,1,-2);
 generate_series
-----------------
               5
               3
               1
(3 rows)
 
SELECT * FROM generate_series(4,3);
 generate_series
-----------------
(0 rows)
 
SELECT generate_series(1.1, 4, 1.3);
 generate_series 
-----------------
             1.1
             2.4
             3.7
(3 rows)
 
-- 这个例子依赖于日期&#43;整数操作符
SELECT current_date &#43; s.a AS dates FROM generate_series(0,14,7) AS s(a);
   dates
------------
 2004-02-05
 2004-02-12
 2004-02-19
(3 rows)
 
SELECT * FROM generate_series(&#39;2008-03-01 00:00&#39;::timestamp,
                              &#39;2008-03-04 12:00&#39;, &#39;10 hours&#39;);
   generate_series   
---------------------
 2008-03-01 00:00:00
 2008-03-01 10:00:00
 2008-03-01 20:00:00
 2008-03-02 06:00:00
 2008-03-02 16:00:00
 2008-03-03 02:00:00
 2008-03-03 12:00:00
 2008-03-03 22:00:00
 2008-03-04 08:00:00
(9 rows)</code>
  </pre>
  </div>
<p><strong>表.下标生成函数</strong>







<table class="table table-striped">
<thead>
<tr>
<th>函数</th>
<th>返回类型</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>generate_subscripts(array anyarray, dim  int)</td>
<td>setof int</td>
<td>生成一个级数组成给定数组的下标。</td>
</tr>
<tr>
<td>generate_subscripts(array anyarray, dim  int, reverse boolean)</td>
<td>setof int</td>
<td>生成一个级数组成给定数组的下标。当reverse为真，级数以逆序返回。</td>
</tr>
</tbody>
</table>
</p>
<p>generate_subscripts是一个快捷函数，它为给定数组的指定维度生成一组合法的下标。对于不具有请求维度的数组返回零行，对于 NULL 数组也返回零行（但是会对 NULL 数组元素返回合法的下标）。下面是一些例子：</p>



  
  
  

  
  
  
  

  

  <div class="prism-codeblock ">
  <pre id="1edfcc3" class="language- ">
  <code>-- 基本使用
SELECT generate_subscripts(&#39;{NULL,1,NULL,2}&#39;::int[], 1) AS s;
 s 
---
 1
 2
 3
 4
(4 rows)
生成数组下标
select generate_subscripts( array[&#39;a&#39;,&#39;b&#39;,&#39;c&#39;,&#39;d&#39;],1);
generate_subscripts
---------------------
                   1
                   2
                   3
                   4
(4 rows)
 
-- 表示一个数组，下标和被下标的值需要一个子查询
SELECT * FROM arrays;
         a          
--------------------
 {-1,-2}
 {100,200,300}
(2 rows)
 
SELECT a AS array, s AS subscript, a[s] AS value
FROM (SELECT generate_subscripts(a, 1) AS s, a FROM arrays) foo;
     array     | subscript | value
---------------&#43;-----------&#43;-------
 {-1,-2}       |         1 |    -1
 {-1,-2}       |         2 |    -2
 {100,200,300} |         1 |   100
 {100,200,300} |         2 |   200
 {100,200,300} |         3 |   300
(5 rows)
 
-- 平面化一个 2D 数组
CREATE OR REPLACE FUNCTION unnest2(anyarray)
RETURNS SETOF anyelement AS $$
select $1[i][j]
   from generate_subscripts($1,1) g1(i),
        generate_subscripts($1,2) g2(j);
$$ LANGUAGE sql IMMUTABLE;
CREATE FUNCTION
SELECT * FROM unnest2(ARRAY[[1,2],[3,4]]);
 unnest2 
---------
       1
       2
       3
       4
(4 rows)</code>
  </pre>
  </div>
<p>当FROM子句中的一个函数后面有WITH ORDINALITY时，输出中会追加一个bigint列，它的值从1开始并且该函数输出的每一行加1。这在unnest()之类的集合返回函数中最有用。</p>

    </div>

    

    
                                            </div>
                                            <div><hr class="doc-hr">
<div id="doc-nav" class="d-print-none">

	<div class="row flex-xl-nowrap ">
	<div class="col-sm-6 pt-2 doc-next">
		<a href="../sql-grammar/index.html">
			<div class="card h-100 my-1">
				<div class="card-body py-2">
                    <p class="card-title fs-5 fw-semibold lh-base mb-0"><i class="material-icons align-middle">navigate_before</i> SQL语法</p>
					
				</div>
			</div>
		</a>
        </div>
	<div class="col-sm-6 pt-2 doc-prev">
		<a class="ms-auto" href="../../../contactus/index.html">
			<div class="card h-100 my-1 text-end">
				<div class="card-body py-2">
                    <p class="card-title fs-5 fw-semibold lh-base mb-0">联系我们 <i class="material-icons align-middle">navigate_next</i></p>
					
				</div>
			</div>
		</a>
        </div>
	</div>
</div></div>
                                        </div>
                                    </div>
                                </div>
                            </div>
<footer class="shadow py-3 d-print-none">
    <div class="container-fluid">
        <div class="row align-items-center">
            <div class="col">
                <div class="text-sm-start text-center mx-md-2">
                    <p class="mb-0">
                        
                        
                    </p>
                </div>
            </div>
        </div>
    </div>
</footer>
</main>
            </div>
        </div>

        
        
        <button onclick="topFunction()" id="back-to-top" aria-label="Back to Top Button" class="back-to-top fs-5"><svg width="24" height="24"><path d="M12,10.224l-6.3,6.3L4.32,15.152,12,7.472l7.68,7.68L18.3,16.528Z" style="fill:#fff"/></svg></button>
        
        

        
        
            <script>(()=>{var e=document.getElementById("mode");e!==null&&(window.matchMedia("(prefers-color-scheme: dark)").addEventListener("change",e=>{e.matches?(localStorage.setItem("theme","dark"),document.documentElement.setAttribute("data-dark-mode","")):(localStorage.setItem("theme","light"),document.documentElement.removeAttribute("data-dark-mode"))}),e.addEventListener("click",()=>{document.documentElement.toggleAttribute("data-dark-mode"),localStorage.setItem("theme",document.documentElement.hasAttribute("data-dark-mode")?"dark":"light")}),localStorage.getItem("theme")==="dark"?document.documentElement.setAttribute("data-dark-mode",""):document.documentElement.removeAttribute("data-dark-mode"))})()</script>
        




    
        
        
    
    






    

    <script src="../../../js/bootstrap.eac7ee3f6fa791c684e7a51fc2fd50b6f724271b9e39562e4fe8c3942412df3acbfc4045f043d03399dac70091207507.js"  defer></script>


    <script type="text/javascript" src="../../../js/bundle.min.ad2cedf5bf6173166579295b890c8a020e465c578d1a8833a9fad762c06e1e5133eb6f348c2644eb0bacfc38149db152.js"   crossorigin="anonymous" defer></script>
        

        
        
    </body>

<!-- Mirrored from docs.memfiredb.com/docs/db/guides/functions-and-operations/ by HTTrack Website Copier/3.x [XR&CO'2014], Fri, 27 Jun 2025 07:56:48 GMT -->
</html>